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INTRO (3) 


INTRO (3) 


NAME 

intro - introduction to subroutines and libraries 

SYNOPSIS 

^include <stdio.h> 

#include <math.h> 

HP-UX COMPATIBILITY 

Level: The level given is the level for which the library is available, not the level at which the 

linkable object code appears. The supporting host will contain appropriate libraries 
for HP-UX/RUN ONLY and HP-UX/NUCLEUS systems. 

Origin: System III, System V, UCB 

DESCRIPTION 

This section describes functions found in various libraries, other than those functions that directly 
invoke HP-UX system primitives, which are described in Section 2 of this volume. Certain major 
collections are identified by a letter after the section munber: 

(3C) These functions, together with those of Section 2 and those marked (3S), constitute the 
Standard C Library Hbc, which is automatically loaded by the C compiler, cc(l). The link 
editor ld{l) searches this library under the -Ic option. Declarations for some of these func¬ 
tions may be obtained from #include files indicated on the appropriate pages. 

(3M) These functions constitute the Math Library, libm. They are automatically loaded as 
needed by the FORTRAN compiler /77(1). They are not automatically loaded by the C 
compiler, cc(l); however, the link editor searches this library under the -Im option. 
Declarations for these functions may be obtained from the ^include file <math.h>. 
Several generally useful mathematical constants are also defined there (see math{5)). 

(3N) These functions constitute the networking library, libn. The link editor searches this 
library under the -In option. Declarations for these functions can be obtained from the 
^include file <stdio.h>, 

(3S) These functions constitute the “standard I/O package” (see stdio{^S)). These functions are 
in the library libc^ already mentioned. Declarations for these functions may be obtained 
from the ^include file <stdio.h>. 

(3X) Various specialized libraries. The files in which these libraries are found are given on the 
appropriate pages. 

DEFINITIONS 

A character is any bit pattern able to fit into a byte on the machine. The null character is a 
character with value 0, represented in the C language as ’\0’. A character array is a sequence of 
characters. A null-terminated character array is a sequence of characters, the last of which is the 
null character. A string is a designation for a null-terminated character array. The null string is 
a character array containing only the null character. A NULL pointer is the value that is 
obtained by casting 0 into a pointer. The C language guarantees that this value will not match 
that of any legitimate pointer, so many functions that return pointers return it to indicate an 
error. NULL is defined as 0 in <stdio.h>; the user can include an appropriate definition if not 
using <stdio.h>. 

FILES 

/lib/libc.a 

/lib/libm.a 

/lib/libn.a 

SEE ALSO 

intro(2), stdio(3S), math(5). 

ar(l), cc(l), f77(l), ld(l), lint(l), nm(l), ranlib(l), intro(2), stdio(3S). 

DIAGNOSTICS 

Functions in the C and Math Libraries (3C and 3M) may return the conventional values 0 or 
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±HUGE (the largest-magnitude single-precision floating-point nmnbers; HUGE is defined in the 
<math.h> header file) when the function is undefined for the given argiunents or when the value 
is not representable. In these cases, the external variable errno (see errno{2)) is set to the value 
EDOM or ERANGE. 

WARNING 

Many of the functions in the libraries call and/or refer to other functions and external variables 
described in this section and in section 2 {System Calls). If a program inadvertantly defines a 
function or external variable with the same name, the presumed library version of the function or 
external variable may not be loaded. The lint(l) program checker reports name conflicts of this 
kind as “multiple declarations” of the names in question. Definitions for sections 2, 3C, and 3S 
are checked automatically. Other definitions can be included by using the -1 option (for example, 
-Im includes definitions for the Math Library, section 3M). Use of lint is highly recommended. 
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NAME 

a641, 164a - convert between long integer and base-64 ASCII string 

SYNOPSIS 

long a641 (s) 
char *s; 

char *164a (1) 
long 1; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

These functions are used to maintain numbers stored in base-64 ASCII characters. This is a 
notation by which long integers can be represented by up to six characters; each character 
represents a "digit" in a radix-64 notation. 

The characters used to represent "digits" are . for 0, / for 1, 0 through 9 for 2-11, A through Z 
for 12-37, and a through z for 38-63. 

The leftmost character is the least significant digit. For example, 
aO = (38 X 64°) + (2 x 64*) = 166 

A 64 I takes a pointer to a null-terminated base-64 representation and returns a corresponding 
long value. If the string pointed to by s contains more than six characters, a64l will use the first 
six. 

L64a takes a long argument and returns a pointer to the corresponding base-64 representation. 
If the argument is 0, 164 a returns a pointer to a null string. 

BUGS 

The value returned by I64a is a pointer into a static buffer, the contents of which are overwritten 
by each call. 
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NAME 

abort - generate an lOT fault 

SYNOPSIS 

int abort ( ) 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Abort first closes all open files if possible, then causes the SIGIOT signal to be sent to the process. 
This usually results in termination with a core dump. 

It is possible for abort to return control if SIGIOT is caught or ignored, in which case the value 
returned is that of the kill{2) system call. 

SEE ALSO 

adb(l), exit(2), kill(2), signal(2). 

DIAGNOSTICS 

If SIGIOT is neither caught nor ignored, and the current directory is writable, a core dump is 
produced and the message “abort - core dmnped” is written by the shell. 
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NAME 

abs - return integer absolute value 

SYNOPSIS 

int abs (i) 
int i; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Abs returns the absolute value of its integer operand. 

HARDWARE DEPENDENCIES 

Series 200/500 and Integral Personal Computer: 

The largest negative integer recognized by the system returns itself. 

SEE ALSO 

floor(3M). 
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NAME 

assert - verify program assertion 
SYNOPSIS 

^include <assert.h> 

assert (expression) 
int expression; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

This macro is useful for putting diagnostics into programs. When it is executed, if expression is 
false (zero), assert prints 

“Assertion failed: expression, file xyz, line nnn” 

on the standard error output and aborts. In the error message, xyz is the name of the source file 
and nnn the source line number of the assert statement. 

Compiling with the preprocessor option -DNDEBUG (see cpp{l)), or with the preprocessor con¬ 
trol statement “#define NDEBUG” ahead of the “^include <assert.h>” statement, will stop 
assertions from being compiled into the program. 

SEE ALSO 

cpp(l), abort(3C). 
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NAME 

atof, atoi, atol - convert ASCII to numbers 

SYNOPSIS 

double atof (nptr) 
char *nptr; 

int atoi (nptr) 
char *nptr; 

long atoi (nptr) 
char *nptr; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin; System III 

DESCRIPTION 

These functions convert a string pointed to by nptr to floating, integer, and long integer represen¬ 
tation respectively. The first unrecognized character ends the string. 

Atof recognizes an optional string of tabs and spaces, then an optional sign,' then a string of digits 
optionally containing a decimal point, then an optional e or E followed by an optionally signed 
integer. 

Atoi and atoi recognize an optional string of tabs and spaces, then an optional sign, then a string 
of digits. 

HARDWARE DEPENDENCIES 
Series 200/500: 

Atoi and atoi are identical. 

SEE ALSO 

scanf(3S). 

BUGS 

There are no provisions for overflow. 
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NAME 

jO, jl, jn, yO, yl, yn - Bessel functions 
SYNOPSIS 

#include <math.h> 

double jO (x) 
double x; 

double jl (x) 
double x; 

double jn (n, x) 
int n; 
double x; 

double yO (x) 
double x; 

double yl (x) 
double x; 

double yn (n, x) 
int n; 
double x; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

JO and jl return Bessel functions of x of the first kind of orders 0 and 1 respectively. Jn returns 
the Bessel function of x of the first kind of order n. 

YO and yl return the Bessel functions of x of the second kind of orders 0 and 1 respectively. Yn 
returns the Bessel function of x of the second kind of order n. The value of x must be positive. 

DIAGNOSTICS 

Non-positive arguments cause yO, yl and yn to return the value -HUGE and to set errno to 
EDOM. They also cause a message indicating DOMAIN error to be printed on the standard error 
output; the process will continue. 

Arguments too large in magnitude cause jO, jl, yO and yl to return zero and to set errno to 
ERANGE. In addition, a message indicating TLOSS error is printed on the standard error out¬ 
put. 

These error-handling procedures may be changed with the function matherr{3M). 

SEE ALSO 

matherr(3M). 
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NAME 

bsearch - binary search a sorted table 

SYNOPSIS 

char *bsearch ((char *) key, (char *) base, nel, sizeof (*key), compar) 
unsigned nel; 
int (♦compar) ( ); 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Bsearch is a binary search routine generalized from Knuth (6.2.1) Algorithm B. It returns a 
pointer into a table indicating where a datum may be found. The table must be previously sorted 
in increasing order according to a provided comparison function. Key points to a datum instance 
to be sought in the table. Base points to the element at the base of the table. Nel is the number 
of elements in the table. Compar is the name of the comparison function, which is called with 
two arguments that point to the elements being compared. The function must return an integer 
less than, equal to, or greater than zero as accordingly the first argument is to be considered less 
than, equal to, or greater than the second. 

EXAMPLE 

The example below searches a table containing pointers to nodes consisting of a string and its 
length. The table is ordered alphabetically on the string in the node pointed to by each entry. 

This code fragment reads in strings and either finds the corresponding node and prints out the 
string and its length, or prints an error message. 

#include <stdio.h> 

#define TABSIZE 1000 

struct node { /♦ these are stored in the table */ 

char ♦string; 
int length; 

}; 

struct node table[TABSIZE]; /♦ table to be searched ♦/ 


struct node ♦node—ptr, node; 

int node_compare( ); /♦ routine to compare 2 nodes ♦/ 

char str^pace[20]; /♦ space to read string into ♦/ 


node.string = str_space; 

while (scanf("%s", node.string) != EOF) { 

node_ptr = (struct node ♦)bsearch((char ♦)(&:node), 
(char ♦)table, TABSIZE, 
sizeof (struct node), node_compare); 
if (node_ptr != NULL) { 

(void)printf("string = %20s, length = %d\n", 
node_ptr—>string, node_ptr— >length); 

} else { 
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(void)printf("not found: %s\n", node.string); 

} 

} 

} 

/* 


This routine compares two nodes based on an 
alphabetical ordering of the string field. 

*/ 

int 

node_compare(nodel, node2) 
struct node *nodel, *node2; 

{ 


return strcmp(nodel—>string, node2—>string); 

} 


NOTES 

The pointers to the key and the element at the base of the table should be of type pointer-to- 
element, and cast to type pointer-to-character. 

The comparison fimction need not compare every byte, so arbitrary data may be contained in the 
elements in addition to the values being compared. 

Although declared as type pointer-to-character, the value returned should be cast into type 
pointer-t o-element. 


SEE ALSO 

hsearch(3C), lsearch(3C), qsort(3C), tsearch(3C). 

DIAGNOSTICS 

A NULL pointer is returned if the key cannot be found in the table. 

BUGS 

A random entry is returned if more than one entry matches the selection criteria. 
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NAME 

catread - MPE/RTE-style message catalog support 
SYNOPSIS 

int catread (fd, set_num, msg_num, msg_buf, buflen [,arg]...) 
int fd, set_num, msg_num, buflen; 
char *msg_buf, *arg; 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Native Language Support: 

8-bit data, customs, messages 

DESCRIPTION 

Catread is layered on getmsgfSC) for supporting message catalog applications from MPE/RTE. 
Refer to the external specifications for message catalogs on these systems for use of this routine. 

The message read from the catalog may have embedded formatting information in the form 
{[digit]. An exclamation mark followed by a digit n is replaced by the nth argument string. If 
exclamation marks are not numbered, they are replaced by the arguments in serial order. Either 
all or none must be numbered. 

If successful, returns the number of non-null bytes placed in the buffer. 

DIAGNOSTICS 

Catread returns a negative integer if seL-num or msg—num are not found in the catalog. 

SEE ALSO 

gencat(l), getmsg(3C), hpnls(7). 
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NAME 

clock - report CPU time used 

SYNOPSIS 

long clock ( ) 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Clock returns the amount of CPU time (in microseconds) used since the first call to clock. The 
time reported is the sum of the user and system times of the calling process and its terminated 
child processes for which it has executed wait(2) or system{SS). 

The resolution of the clock varies depending on the hardware and software configuration. See 
HARDWARE DEPENDENCIES for the various vales. 

SEE ALSO 

times(2), wait(2), system(3S). 

HARDWARE DEPENDENCIES 

Series 200: The clock resolution is 20 milliseconds. 

Series 500: The clock resolution is 10 milliseconds as a default. 

BUGS 

The value returned by clock is defined in microseconds for compatibility with systems that have 
CPU clocks with much higher resolution. Because of this, the value returned will wrap around 
after accumulating only 2147 seconds of CPU time (about 36 minutes). 
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NAME 

toupper, tolower, _toupper, _tolower, toascii - translate characters 
SYNOPSIS 

^include <ctype.h> 

int toupper (c) 
int c; 

int tolower (c) 
int c; 

int _toupper (c) 
int c; 

int —tolower (c) 
int c; 

int toascii (c) 
int c; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Toupper and tolower have as domain the range of getc[Z^): the integers from -1 through 255. If 
the argument of toupper represents a lower-case letter, the result is the corresponding upper-case 
letter. If the argument of tolower represents an upper-case letter, the result is the corresponding 
lower-case letter. All other arguments in the domain are returned unchanged. 

The macros_ toupper and_ tolower accomplish the same thing as toupper and tolower but have 

restricted domains and are faster. _toupper requires a lower-case letter as its argument; its result 

is the corresponding upper-case letter. The macro_ tolower requires an upper-case letter as its 

argument; its result is the corresponding lower-case letter. Arguments outside the domain cause 
undefined results. Use of this form will never work with foreign character sets. 

Toascii yields its argument with all bits turned off that are not part of a standard 7 bit ASCII 
character; it is intended for compatibility with other systems. 

SEE ALSO 

ascii(7), ctype(3C), getc(3S), nl—conv(3C). 
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NAME 

crypt - generate password encryption 
SYNOPSIS 

char *crypt (key, salt) 
char *key, *salt; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Crypt is the password encryption function. It is based on the NBS Data Encryption Standard 
(DES), with variations intended (among other things) to frustrate use of hardware implementa¬ 
tions of the DES for key search. 

Key is a user’s typed password. Salt is a two-character string chosen from the set [a-zA-ZO- 
9 ./]; this salt string is used to perturb the DES algorithm in one of 4096 different ways, after 
which the password is used as the key to encrypt repeatedly a constant string. The returned 
value points to the encrypted password, in the same alphabet as the salt. The first two characters 
are the salt itself. 

SEE ALSO 

logm(l), passwd(l), getpass(3C), passwd(5) 

BUGS 

The return value points to static data that is overwritten by the next call to crypt (SC). 
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NAME 

ctermid - generate file name for terminal 
SYNOPSIS 

#include <8tdio.h> 
char *ctermid (s) 
char *s; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Ctermid generates the path name of the controlling terminal for the current process, and stores it 
in a string. 

If 5 is a NULL pointer, the string is stored in an internal static area, the contents of which are 
overwritten at the next call to ctermid^ and the address of which is returned. Otherwise, s is 
assmned to point to a character array of at least L_ctermid elements; the path name is placed in 
this array and the value of s is returned. The constant L_ctermid is defined in the <stdio.h> 
header file. 

NOTES 

The difference between ctermid and ttyname(SC) is that ttyname must be handed a file descriptor 
and returns the actual name of the terminal associated with that file descriptor, while ctermid 
returns a string (/dev/tty) that will refer to the terminal if used as a file name. Thus ttyname is 
useful only if the process already has at least one file open to a terminal. 

SEE ALSO 

ttyname (3C). 
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NAME 

ctime, nl_ctime, daylight, localtime, gmtime, asctime, nl_asctime, timezone, tzset, tzname - con¬ 

vert date and time to string 

SYNOPSIS 

^include <time.h> 

char *ctime (clock) 
long *clock; 

char *nl_ctime (clock, format, langid) 

long *clock; char ^format; int langid; 

struct tm *localtime (clock) 
long *clock; 

struct tm *gmtime (clock) 
long *clock; 

char *asctime (tm) 
struct tm *tm; 

char *nl_asctime (tm, format, langid) 

struct tm *tm; char ^format; int langid; 

extern long timezone; 
extern int daylight; 
extern char *tzname[2]; 
void tzset ( ) 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

Native Language Support: 

8-bit data, customs, messages 

DESCRIPTION 

Ctime converts a long integer, pointed to by clocks representing the time in seconds since 00:00:00 
GMT, January 1, 1970, and returns a pointer to a 26-character string in the following form. All 
the fields have constant width. 

Sun Sep 16 01:03:52 1973\n\0 

NL—ctime extends the capabilities of ctime in two ways. First the format specification allows the 
date and time to be output in a variety of ways. Format uses the field descriptors defined in 
date(l). If the format is the null string, the D_T_FMT string defined by langinfo(3G) is used. 
Second langid provides month and weekday names (when selected as alphabetic by the format 
string) to be in the user’s native language. 

Localtime and gmtime return pointers to “tm” structures, described below. Localtime corrects 
for the time zone and any summer time zone corrections (Daylight Savings time in the US), 
according to the TZ string in the user’s environment. Gmtime converts directly to Greenwich 
Mean Time (GMT), which is the time the HP-UX System uses. 

Asctime converts a “tm” structure to a 26-character string, as shown in the above example, and 
returns a pointer to the string. 

Nl^asctime, like nl—ctime, allows the date string to be formatted, and month and weekday 
names to be in the user’s native language. However, like asctime , it takes “tm” as its argument. 
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Declarations of all the functions and externals, and the “tm” structure, are in the <time.h> 
header file. The structure declaration is; 


struct tm { 


int tm_sec; 

/* seconds (0 - 59) */ 

int tm_min; 

/* minutes (0 -59) */ 

int tm_hour; 

/* hours (0 - 23) */ 

int tm_mday; 

/* day of month (1 - 31) */ 

int tm_mon; 

/* month of year (0 - 11) */ 

int tm_year; 

/* year - 1900 */ 

int tm_^wday; 

/* day of week (Sunday = 0) */ 

int tm_yday; 

/* day of year (0 - 365) */ 

int tm_isdst; 



}; 

TiU—isdst is non-zero if a summer time zone correction such as Daylight Savings time is in effect. 

The external long variable timezone contains the difference, in seconds, between GMT and local 
standard time (in EST, timezone is 5*60*60); the external variable daylight is non-zero if and only 
if you have specified a summer time zone correction in your TZ environment variable. The values 
of the external variables timezone^ daylight^ and tzname are set from the environment variable TZ 
by the function tzset, which may be called directly, or indirectly through the functions localtime, 
ctime, or nL-ctime. TZ is set by default when the user logs on, to a value in the local 
/etc/profile file (see profile{b)). 

HARDWARE DEPENDENCIES 
Series 200/500: 

Tztab{b) is not currently supported. 

SEE ALSO 

time(2), getenv(3C), langinfo(3C), profile(5), environ(7), hpnls(7). 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, isgraph, iscntrl, isascii - 
classify characters 

SYNOPSIS 

^include <ctype.h> 

int isalpha (c) 
int c; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

These macros classify character-coded integer values by table lookup. Each is a predicate return¬ 
ing nonzero for true, zero for false. Isascii is defined on all integer values; the rest are defined 
only where isascii is true and on the single non-ASCII value EOF (see stdio{3S)). 


isalpha 

c is a letter. 

isupper 

c is an upper-case letter. 

islower 

c is a lower-case letter. 

isdigit 

c is a digit [0-9]. 

isxdigit 

c is a hexadecimal digit [0-9], [A-F] or [a-f|. 

isalnum 

c is an alphanumeric (letter or digit). 

isspace 

c is a space, tab, carriage return, new-line, vertical tab, or form-feed. 

ispunct 

c is a punctuation character (neither control nor alphanumeric). 

isprint 

c is a printing character, code 040 (space) through 0176 (tilde). 

isgraph 

c is a printing character, like isprint except false for space. 

iscntrl 

c is a delete character (0177) or an ordinary control character (less than 040). 

isascii 

c is an ASCII character, code less than 0200. 

DIAGNOSTICS 


If the argument 

to any of these macros is not in the domain of the function, the result 

undefined. 


SEE ALSO 


nl_ctype(3C), stdio(3S), ascii(7). 
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NAME 

curses - CRT screen handling and optimization package 
SYNOPSIS 

#include <curses.h> 

cc [ flags ] flies -Icurses [ libraries ] 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

These routines provide a means for updating screens with reasonable optimization. To ensure 
proper initialization, the routine initscr() must be called before any other routines that deal with 
windows and screens are used. The endwin() routine should be called before exiting to restore 
conditions as they existed prior to program entry. Character-at-a-time input without echoing 
(used in most interactive, screen oriented-programs), is obtained by calling “nonl(); cbreak(); 
noecho();” after calling initscr(). 

The full-cwrse5 interface provides a means for manipulating window data structures. Windows 
can be thought of as two-dimensional arrays of characters representing all or part of a CRT 
screen. A default window called stdscr is supplied. Other windows can be created by using 
newwin. Windows are referred to by variables declared “WINDOW the type WINDOW is 
defined in curses, h to be a C structure. These data structures are manipulated with functions 
described below. Two simple (and widely used) examples are move and addch. (More-general 
versions of these functions are provided. Their names begin with ‘w’, to signify that you can 
specify the window to be used. Routines not beginning with ‘w’ affect only stdscr.) After mani¬ 
pulation, refresh() is called to make the user’s CRT screen look like stdscr. 

Mini-Curses is a subset of curses. It only supports manipulation of the standard window. To 
invoke this subset, use -DMINICURSES as a cc option. This level is smaller and faster than full 
curses. 


If the environment variable TERMINFO is defined, any program using curses checks for a local 
terminal definition before checking in the standard place. For example, if the standard place is 
/users/lib/terminfo, and TERM is set to “hp2623”, the compiled file is normally found in 
/users/lib/terminfo/h/hp2623 (the “h” is copied from the first letter of “hp2623” to avoid 
creation of huge directories). However, if TERMINFO is set to /users/mark/myterms, curses 
first checks /users/mark/myterms/h/hp2623, then, if that fails, checks 
/usr/lib/terminfo/h/hp2623. This is useful when developing experimental definitions and 
when write permission in /users/lib/terminfo is not available. 

SEE ALSO 

terminfo(5) and termcap(3). 

FUNCTIONS 

All routines listed here are fully accessible to full curses. Those marked with an asterisk are also 
available to Mini-Curses. 


addch(ch)* 

addstr(str)* 

attroff(attrs)* 

attron(attrs)* 

attrset(attrs)* 

baud rate()* 

beepO* 

box(wm, vert, hor) 


add a character to (like putchar) 

(wraps to next line at end of line) 

calls addch with each character in str 

turn off attributes named 

turn on attributes named 

set current attributes to attrs 

current terminal speed 

sound beep on terminal 

draw a box around edges of win 

vert and hor are chars to use for vert. 
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cbreak()* 
clear( )* 
clearok(wm, bf) 
clrtobot() 
clrtoeol() 

delay_output(nis) * 
delchO 
deleteln() 
delwin(win) 
doupdate() 
draino(ins) 
echo()* 
endwiii( )* 
eraseO* 
erasecharO* 
fixterm() 
flash( )* 
fiushinpO* 
getch() 
getstr(str) 
gettmode() 
getyx(wm, y, x) 
has_ic()* 
has_il()* 
idlok(win, bf)* 
inch() 
initscrO* 
insch(c) 
insertlii() 
intrflush(win, bf) 
keypad(win, bf) 
killcharO* 
leaveok(win, flag) 


longname() 

meta(win, flag)* 

move(y, x)* 

mvaddch(y, x, ch)* 

mvaddstr(y, x, str)* 

mvcur(oldrow, oldcol, newrow, newcol) 

mvdelch(y, x) 

mvgetch(y, x) 

mvgetstr(y, x, str) 

mvinch(y, x) 

mvinsch(y, x, c) 

mvprintw(y, x, fmt, args) 

mvscanw(y, x, fmt, args) 

mvwaddch(win, y, x, ch) 

mvwaddstr(win, y, x, str) 

mvwdelch(wm, y, x) 

rnvwgetch(win, y, x) 

mvwgetstr(win, y, x, str) 


and hor. edges of box 
set cbreak mode 
clear stdscr 

clear screen before next redraw of win 

clear to bottom of stdscr 

clear to end of line on stdscr 

insert ms millisecond pause in output 

delete a character 

delete a line 

delete win 

update screen from all wnooutrefresh 
drain output to ms milliseconds 
set echo mode 
end window modes 
erase stdscr 

return user’s erase character 

restore tty to "in curses" state 

flash screen or beep 

throw away any typeahead 

get a char from tty 

get a string through stdscr 

dummy entry point. Does nothing. 

get (y, x) co-ordinates 

true if terminal can do insert character 

true if terminal can do insert line 

use terminal’s insert/delete line if bf != 0 

get char at current (y, x) co-ordinates 

initialize screens 

insert a char 

insert a line 

interrupts flush output if bf is TRUE 

enable keypad input 

return current user’s kill character 

OK to leave cursor anywhere after refresh if 

flag!=0 for win, otherwise cursor must be left 

at current position. 

return verbose name of terminal 

allow meta characters on input if flag != 0 

move to (y, x) on stdscr 

move(y, x) then addch(ch) 

move(y, x) then addstr(str) 

low-level cursor motion 

like delch, but move(y, x) first 

etc. 


Hewlett-Packard 


-2- 


July 2, 1985 




CURSES (3X) 


CURSES (3X) 


invwm(win, by, bx) 
nivwinch(win, y, x) 
mvwmsch(wm, y, x, c) 
mvwprintw(win, y, x, fmt, args) 
mvwscanw(win, y, x, fmt, args) 
napms(ms) 
newpad(nlmes, ncols) 
newterm(type, fpout, fpin)* 

newwin(lines, cols, begin_y, begin_x) 

nlO* 

nocbreak()* 
nodelay(win, bf) 
noechoO* 
nonl()* 
noraw ()* 

overlay(winl, win2) 
overwrite (win 1, win2) 
pnoutrefresh(pad, pminrow, pmincol, 
sminrow, smincol, smaxrow, smaxcol) 
prefresh(pad, pminrow, pmincol, 

sminrow, smincol, smaxrow, smaxcol) 

printw(fmt, argl, arg2, ...) 

raw( )* 

refresh ()* 

resetterm( )* 

resetty( )* 

saveterm( )* 

savetty( )* 

scanw(fmt, argl, arg2, ...) 
scroll (win) 
scrollok(win, flag) 
set_term(new)* 
setscrreg(t, b) 
setterm(type) 

setupterm(term, filenum, errret) 
standend( )* 
standout ()* 

subwin(win, lines, cols, begin_ y, begin_x) 

touchwin(win) 
traceoff() 
traceon() 
typeahead(fd) 
unctrl(ch)* 
waddch(win, ch) 
waddstr(win, str) 
wattroff(win, attrs) 
wattron(win, attrs) 
wattrset(win, attrs) 
wclear(win) 
wclrtobot(win) 
wclrtoeol(win) 
wdelch(win, c) 
wdeleteln(win) 


suspend program for ms milliseconds 

create a new pad with given dimensons s 

set up new terminal of given type to I/O on fpout/fpin. 

create a new window. 

set newline mapping 

unset cbreak mode 

enable nodelay input mode through getch 

imset echo mode 

imset newline mapping 

unset raw mode 

overlay winl on win2 

overwrite winl on top of win2 

like prefresh but with no output until doupdate called 

refresh from pad starting with given upper left corner 
of pad with output to given portion of screen 
printf on stdscr 
set raw mode 

make current screen look like stdscr 

set tty modes to "out of curses" state 

reset tty flags to stored value 

save current modes as "in curses" state 

store current tty flags 

scanf through stdscr 

scroll win one line 

allow terminal to scroll if flag != 0 

set the current terminal to new 

set user scrolling region to lines t through b 

establish terminal with given type 

initialize specified terminal 

clear standout mode attribute 

set standout mode attribute 

create a subwindow 

change all of win 

dummy entry point. Does nothing 

dummy entry point. Does nothing 

use file descriptor fd to check typeahead 

printable version of ch 

add char to win 

add string to win 

turn off attrs in win 

turn on attrs in win 

set attrs in win to attrs 

clear win 

clear to bottom of win 
clear to end of line on win 
delete char from win 
delete line from win 
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werase(win) 

wgetch(win) 

wgetstr(win, str) 

wiiich(win) 

wiiisch(win, c) 

winsertln(win) 

wmove(win, y, x) 

wnoutrefresh(win) 

wprintw(win, fmt, argl, arg2, ...) 

wrefresh(win) 

wscanw(win, fmt, argl, arg2, ...) 

wsetscrreg(win, t, b) 

wstandend(wm) 

wstandout(win) 


erase win 

get a char through win 

get a string through win 

get char at current (y, x) in win 

insert char into win 

insert line into win 

set current (y, x) co-ordinates on win 
refresh but no screen output 

printf on win 

make screen look like win 

scanf through win 
set scrolling region of win 
clear standout attribute in win 
set standout attribute in win 


TERMINFO LEVEL ROUTINES 


These routines should be called by programs wishing to deal directly with the terminfo database. 
Due to the low level of this interface, it is discouraged. Initially, setupterm should be called. This 
will define the set of terminal dependent variables defined in terminfo(^). The include files 
<curses.h> and <term.h> should be included to get the definitions for these strings, numbers, 
and flags. Parameterized strings should be passed through tparm to instantiate them. All ter¬ 
minfo strings (including the output of tparm) should be printed with tputs or putp . Before exit¬ 
ing, resetterm should be called to restore the tty modes. (Programs desiring shell escapes or 
suspending with control-Z can call resetterm before the shell is called and fixterm after returning 
from the shell.) 


fixterm() 
resetterm() 

setupterm(term, fd, rc) 


tparm(str, pi, p2, ..., p9) 


restore tty modes for terminfo use 
(called by setupterm) 

reset tty modes to state before program entry 
read in database. Terminal type is the 
character string term, all output is to UNIX 
System file descriptor fd. A status value is 
returned in the integer pointed to by rc: 1 
is normal. The simplest call would be 
setupterm(0, 1, 0) which uses all defaults. 


tputs(str, affcnt, putc) 


putp (str) 

vidputs(attrs, putc) 


instantiate string str with parms p.. 
apply padding info to string str. 
affcnt is the number of lines affected, 
or 1 if not applicable. Putc is a 
putchar-like fimction to which the characters 
are passed, one at a time, 
handy function that calls tputs 
(str, 1, putchar). 

output the string to put terminal in video 
attribute mode attrs, which is any 
combination of the attributes listed below. 


Chars are passed to putchar-like 
function putc. 

vidattr(attrs) Like vidputs but outputs through 

putchar. 
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TERMCAP COMPATIBILITY ROUTINES 


These routines were included as a conversion aid for programs that use termcap. Their parame¬ 
ters are the same as for termcap^ but they are emulated using the terminfo database. They may 
be removed at a later date. 

tgetent(bp, name) look up termcap entry for name 

tgetflag(id) get boolean entry for id 

tgetnum(id) get numeric entry for id 

tgetstr(id, area) get string entry for id 

tgoto(cap, col, row) apply parms to given cap 

tputs(cap, affcnt, fn) apply padding to cap calling fn as putchar 


ATTRIBUTES 


The following video 

A_STANDOUT 

A_UNDERLINE 

A_REVERSE 

A_BLINK 

A_DIM 

A_BOLD 

A_BLANK 

A_PROTECT 

A_ALTCHARSET 


attributes can be passed to the functions attron,attroff,attrset. 
Terminal’s best highlighting mode 
Underlining 
Reverse video 
Blinking 
Half bright 
Extra bright or bold 
Blanking (invisible) 

Protected 

Alternate character set 
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FUNCTION KEYS 

The following function keys are returned by getch if keypad has been enabled and the function is 
supported. Note that some of these may not be currently supported due to lack of definitions in 
terminfo, or because the terminal does not transmit a unique code when the key is pressed. 

Name Value Key name 

KEY_BREAK 0401 break key (unreliable) 

KEY_DOWN 0402 The four arrow keys ... 

KEY_UP 0403 

KEY_LEFT 0404 

KEY_RIGHT 0405 

KEY__HOME 0406 Home key (upward+left arrow) 

KEY_BACKSPACE 0407 backspace (unreliable) 

KEY_F0 0410 Function keys. Space for 64 is reserved. 

KEY_F(n) (KEY_F0+(n)) Formula for fn. 

KEY_JDL 0510 Delete line 

KEY_J[L 0511 Insert line 

KEY_DC 0512 Delete character 

KEY_IC 0513 Insert char or enter insert mode 

KEY__EIC 0514 Exit insert char mode 

KEY_CLEAR 0515 Clear screen 

KEY_EOS 0516 Clear to end of screen 

KEY_EOL 0517 Clear to end of line 

KEY_SF 0520 Scroll 1 line forward 

KEY_SR 0521 Scroll 1 line backwards (reverse) 

KEY_NPAGE 0522 Next page 

KEY_PPAGE 0523 Previous page 

KEY_STAB 0524 Set tab 

KEY_CTAB 0525 Clear tab 

KEY_CATAB 0526 Clear all tabs 

KEY_ENTER 0527 Enter or send (imreliable) 

KEY_SRESET 0530 soft (partial) reset (unreliable) 

KEY_RESET 0531 reset or hard reset (unreliable) 

KEY__PRINT 0532 print or copy 

KEY_LL 0533 home down or bottom (lower left) 

WARNING 

The plotting library p/oi(3X) and the curses library curses(SX) both use the names erase{ ) and 
move{). The curses versions are macros. If you need both libraries, put the plot{SX) code in a 
different source file than the curses{'SX) code, and/or #undef move() and erase{) in the plot{3X) 
code. 
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NAME 

cuserid - get character login name of the user 
SYNOPSIS 

#include <stdio.h> 

char *cuserid (s) 
char *s; 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

Cuserid generates a character-string representation of the login name that the owner of the 
current process is logged in under. If s is a NULL pointer, this representation is generated in an 
internal static area, the address of which is returned. Otherwise, s is assumed to point to an 
array of at least L_cuserid characters; the representation is left in this array. The constant 
L_cuserid is defined in the <stdio.h> header file. 

DIAGNOSTICS 

If the login name cannot be found, cuserid returns a NULL pointer; if s is not a NULL pointer, a 
null character (\0) will be placed at s[0]. 

BUGS 

Cuserid uses getpwnam{3C); thus the results of a user’s call to the latter will be obliterated by a 
subsequent call to the former. 

SEE ALSO 

getlogin(3C), getpwent(3C). 


Hewlett-Packard 


- 1 - 


July 2, 1985 



DIAL(3C) 


DIAL(3C) 


NAME 

dial - establish an out-going terminal line connection 

SYNOPSIS 

^include <dial.h> 

int dial (call) 

CALL call; 

void undial (fd) 
int fd; 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Dial returns a file-descriptor for a terminal line open for read/write. The argument to dial is a 
CALL structure (defined in the <dial.h> header file). 

When finished with the terminal line, the calling program must invoke undial to release the sema¬ 
phore that has been set during the allocation of the terminal device. 

The definition of CALL in the <dialh> header file is: 
typedef struct { 


struct termio *attr; 

/* pointer to termio attribute struct */ 

int 

baud; 

/* transmission data rate */ 

int 

speed; 

/* 212A modem; low=300, high=1200 */ 

char 

*line; 

/* device name for out-going line ♦/ 

char 

*telno; 

/* pointer to tel-no digits string */ 

int 

modem; 

/* specify modem control for direct lines */ 

char 

*device; 

/*Will hold the name of the device usedd 
to make a connection */ 

int 

dev_len; 

/* The length of the device used to 
make connection */ 


} CALL; 

The CALL element speed is intended only for use with an outgoing dialed call, in which case its 
value should be either 300 or 1200 to identify the 113A modem, or the high- or low-speed setting 
on the 212A modem. Note that the 113A modem or the low-speed setting of the 212A modem will 
transmit at any rate between 0 and 300 bits per second. However, the high-speed setting of the 
212A modem transmits and receivers at 1200 bits per second only. The CALL element baud is for 
the desired transmission baud rate. For example, one might set baud to 110 and speed to 800 (or 
1200). However, if speed set to 1200 baud must be set to high (1200). 

If the desired terminal line is a direct line, a string pointer to its device-name should be placed in 
the line element in the CALL structure. Legal values for such terminal device names are kept in 
the L-devices file. In this case, the value of the baud element need not be specified as it will be 
determined from the L-devices file. 


The telno element is for a pointer to a character string representing the telephone number to be 
dialed. Such numbers may consist only of symbols described on the acu{7). The termination 
symbol will be supplied by the dial function, and should not be included in the telno string passed 
to dial in the CALL structure. 

The CALL element modem is used to specify whether or not modem control is required for direct 
lines. This element should be non-zero if modem control is required for the line. The CALL ele¬ 
ment attr is a pointer to a termio structure, as defined in the termio.h header file. A NULL value 
for this pointer element may be passed to the dial function, but if such a structure is included, the 
elements specified in it will be set for the outgoing terminal line before the connection is esta¬ 
blished. This is often important for certain attributes such as parity and baud-rate. 
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The CALL element device is used to hold the device name (cuL.) that establishes the connection. 
The CALL element dev—len is the length of the device name that is copied into the array device. 

FILES 

/usr/lib/uucp/L-devices 

/usr/spool/uucp/LCK..<i?/-demce 

SEE ALSO 

uucp(lC), alarm(2), read(2), write(2), acu(4), termio(4). 

DIAGNOSTICS 

On failure, a negative value indicating the reason for the failure will be returned. Mnemonics for 


these negative indices as 

listed here are defined in the <dial.h> header file. 

INTRPT -1 

/♦ interrupt occurred ♦/ 

D_HUNG -2 

/* dialer hung (no return from write) */ 

NO_AN8 -3 

/* no answer within 10 seconds */ 

ILL_BD -4 

/* illegal baud-rate */ 

A_PROB -5 

/* acu problem (open() failure) */ 

L_PROB -6 

/* line problem (open() failure) */ 

NO^dv -7 

/* can’t open LDEV8 file ♦/ 

DV_NT_A -8 

/* requested device not available */ 

DV_NT_K -9 

/* requested device not known */ 

NO_BD_A -10 

/* no device available at requested baud */ 

NO_BD_K -11 

/* no device known at requested baud */ 


WARNINGS 

Including the <dial.h> header file automatically includes the <termio.h> header file. 

The above routine uses <stdio.h>, which causes it to increase the size of programs, not otherwise 
using standard I/O, more than might be expected. 

BUGS 

An alarm{2) system call for 3600 seconds is made (and caught) within the dial module for the 
purpose of “touching” the LCK.. file and constitutes the device allocation semaphore for the ter¬ 
minal device. Otherwise, uucp{lC) may simply delete the LCK.. entry on its 90-minute clean-up 
rounds. The alarm may go off while the user program is in a read(2) or write{2) system call, 
causing an apparent error return. If the user program expects to be around for an hour or more, 
error returns from reads should be checked for (errno==EINTR), and the read possibly reis¬ 
sued. 
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NAME 

opendir, readdir, telldir, seekdir, rewinddir, closedir - directory operations 
SYNOPSIS 

^include <ndir.h> 

DIR *opendir (filename) 
char * filename; 

struct direct *readdir(dirp) 

DIR *dirp; 

long telldir(dirp) 

DIR *dirp; 

seekdir(dirp, loc) 

DIR *dirp; 
long loc; 

rewinddir (dirp) 

DIR *dirp; 

closedir (dirp) 

DIR *dirp; 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

DESCRIPTION 

The purpose of this library package is to provide functions which allow programs to read directory 
entries without having to know the actual directory format associated with the file system. This 
allows programs to be ported from one file system to another. Therefore, this is the recommended 
way to read directory entries. 

Opendir opens the directory named by filename and associates a directory stream with it. Open¬ 
dir returns a pointer to be used to identify the directory stream in subsequent operations. The 
pointer NULL is returned if filename cannot be accessed, if filename is not a directory, or if 
sufiicient memory cannot be allocated for a buffer of size DIRBLKSIZ blocks (see HARDWARE 
DEPENDENCIES). 

Readdir returns a pointer to the next directory entry. It returns NULL upon reaching the end of 
the directory or detecting an invalid seekdir operation. 

Telldir returns the current location, in bytes, associated with the named directory stream. 

Seekdir sets the position of the next readdir operation on the directory stream. Loc is a byte offset 
within the directory file. The new position reverts to the one associated with the directory stream 
when the telldir operation was performed. Values returned by telldir are good only for the lifetime 
of the DIR pointer from which they are derived. If the directory is closed and then re-opened, the 
telldir value may be invalidated due to undetected directory compaction. It is safe to use a previ¬ 
ous telldir value immediately after a call to opendir and before any calls to readdir. 

Rewinddir resets the position of the named directory stream to the beginning of the directory. 

Closedir causes the named directory stream to be closed, and the structure associated with the 
DIR pointer to be freed. 

See /usr/include/ndir.h for a description of the fields available in a directory entry. The preferred 
way to search the current directory for entry "name" is: 

len = strlen(name); 
dirp = opendir("."); 

for (dp = readdir (dirp); dp != NULL; dp = readdir (dirp)) { 
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if (dp->d_namlen == len !strcmp(dp->d_name, name)) { 

closedir(dirp); 
return FOUND; 

} 

} 

closedir(dirp); 
return NOT_FOUND; 

HARDWARE DEPENDENCIES 
Series 200: 

Malloc(SC) is used to allocate memory. 

Series 500: 

Malloc{SC) is used to allocate memory. 

SEE ALSO 

/usr/include/ndir.h, close(2), lseek(2), open(2), read(2). 
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NAME 

drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, lcong48 - generate uni¬ 
formly distributed pseudo-random numbers 

HP-UX COMPATIBILITY 

Level; HP-UX/RUN ONLY 

Origin: System V 

SYNOPSIS 

double drand48 ( ) 

double erand48 (xsubi) 
unsigned short xsubi[3]; 

long lrand48 ( ) 

long nrand48 (xsubi) 
unsigned short xsubi [3]; 

long mrand48 ( ) 

long jrand48 (xsubi) 
unsigned short xsubi [3]; 

void srand48 (seedval) 
long seedval; 

unsigned short *seed48 (seedl6v) 
unsigned short seedl6v[3]; 

void lcong48 (param) 
unsigned short param[7]; 

DESCRIPTION 

This family of functions generates pseudo-random numbers using the well-known linear 
congruential algorithm and 48-bit integer arithmetic. 

Functions drand^S and erand48 return non-negative double-precision floating-point values uni¬ 
formly distributed over the interval $[0.0,~1.0).$ 

Functions Irand^S and nrand^S return non-negative long integers uniformly distributed over the 
interval $[0,~2 sup 31 ).$ 

Functions mrand^S and jrand48 return signed long integers uniformly distributed over the inter¬ 
val $[-2 sup 31 ,"2 sup 31 ).$ 

Functions srand48, seed48 and lcong48 are initialization entry points, one of which should be 
invoked before either drand48, lrand48 or mrand48 is called. (Although it is not recommended 
practice, constant default initializer values will be supplied automatically if drand48, lrand48 or 
mrand48 is called without a prior call to an initialization entry point.) Functions erand48, 
nrand48 and jrand48 do not require an initialization entry point to be called first. 

All the routines work by generating a sequence of 48-bit integer values, $X sub i ,$ according to 
the linear congruential formula 

X sub{n+l}''=''(aX sub n"+"c) sub{roman modern} n>=0. 

The parameter $m"="2 sup 48$; hence 48-bit integer arithmetic is performed. Unless lcong48 
has been invoked, the multiplier value $a$ and the addend value $c$ are given by 

a^mark =~roman 5DEECE66D"sub 16''=~roman 273673163155"sub 8 
c~lineup =~roman B"sub 16~=~roman 13"sub 8 . 
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The value returned by any of the functions drand48, erand48, lrand48, nrand48, mrand48 or 
jrand48 is computed by first generating the next 48-bit $X sub i$ in the sequence. Then the 
appropriate number of bits, according to the type of data item to be returned, are copied from the 
high-order (leftmost) bits of $X sub i$ and transformed into the returned value. 

The functions drand48, lrand48 and mrand48 store the last 48-bit $X sub i$ generated in an 
internal buffer; that is why they must be initialized prior to being invoked. The functions 
erand48, nrand48 and jrand48 require the calling program to provide storage for the successive 
$X sub i$ values in the array specified as an argument when the functions are invoked. That is 
why these routines do not have to be initialized; the calling program merely has to place the 
desired initial value of $X sub i$ into the array and pass it as an argument. By using different 
arguments, functions erand48, nrand48 and jrand48 allow separate modules of a large program to 
generate several independent streams of pseudo-random numbers, i.e., the sequence of numbers in 
each stream will not depend upon how many times the routines have been called to generate 
numbers for the other streams. 

The initializer function srand48 sets the high-order 32 bits of $X sub i$ to the 32 bits contained 
in its argument. The low-order 16 bits of $X sub i$ are set to the arbitrary value Sroman 330E 
sub 16 .$ 

The initializer function seed48 sets the value of $X sub i$ to the 48-bit value specified in the 
argument array. In addition, the previous value of $X sub i$ is copied into a 48-bit internal 
buffer, used only by seed48, and a pointer to this bufiFer is the value returned by seed48. This 
returned pointer, which can just be ignored if not needed, is useful if a program is to be restarted 
from a given point at some future time — use the pointer to get at and store the last $X sub i$ 
value, and then use this value to reinitialize via seed48 when the program is restarted. 

The initialization function lcong48 allows the user to specify the initial $X sub i ,$ the multiplier 
value $a,$ and the addend value $c.$ Argument array elements param[0-2] specify $X sub i ,$ 
param[3-5] specify the multiplier $a,$ and param[6] specifies the 16-bit addend $c.$ After 
lcong48 has been called, a subsequent call to either srand48 or seed48 will restore the “standard” 
multiplier and addend values, $a$ and $c,$ specified on the previous page. 

SEE ALSO 

rand(3C). 
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NAME 

ecvt, fcvt, gcvt, n]_gcvt - convert floating-point number to string 

SYNOPSIS 

char *ecvt (value, ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, tsign; 

char *fcvt (value, ndigit, decpt, sign) 

double value; 

int ndigit, * decpt, *sign; 

char *gcvt (value, ndigit, buf) 
double value; 
int ndigit; 
char ♦buf; 

char ♦nl_gcvt (value, ndigit, buf, langid) 

double value; 
int ndigit; 
char ♦buf; 
int langid; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

Native Language Support: 

8-bit data, customs, messages 

DESCRIPTION 

Ecvt converts value to a null-terminated string of ndigit digits and returns a pointer thereto. 
The high-order digit is non-zero, unless the value is zero. The low-order digit is rounded. The 
position of the decimal point relative to the beginning of the string is stored indirectly through 
decpt (negative means to the left of the returned digits). The decimal point is not included in the 
returned string. If the sign of the result is negative, the word pointed to by sign is non-zero, oth¬ 
erwise it is zero. 

Fcvt is identical to ecvt, except that the correct digit has been rounded for printf “%f” (FOR¬ 
TRAN F-format) output of the number of digits specifled by ndigit. 

Gcvt converts the value to a null-terminated string in the array pointed to by buf and returns 
buf. It attempts to produce ndigit significant digits in FORTRAN F-format if possible, otherwise 
E-format, ready for printing. A minus sign, if there is one, or a decimal point will be included as 
part of the returned string. Trailing zeros are suppressed. 

Nl—gcvt differs from gcvt only in that it uses langid to determine what the radix character should 
be (e.g., or If langid is not valid, or information for langid has not been installed, the radix 
character defaults to a period. 

SEE ALSO 

printf(3S), hpnls(7), langid(7). 

BUGS 

The values returned by ecvt and fcvt point to a single static data array whose content is overwrit¬ 
ten by each call. 
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END(3C) 


NAME 

end, etext, edata - last locations in program 

SYNOPSIS 

extern char end; 
extern char etext; 
extern char edata; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

These names refer neither to routines nor to locations with interesting contents. The address of 
etext is the first address above the program text, edata above the initialized data region, and end 
above the uninitialized data region. Note that the definition of each of these is implementation- 
dependent. See HARDWARE DEPENDENCIES below. 

When execution begins, the program break (the first location beyond the data) coincides with 
end, but the program break may be reset by the routines of brk{2)^ malloc(SC), standard 
input/output (stdio{3S)), the profile (-p) option of cc(l), and so on. Thus, the current value of 
the program break should be determined by sbrk(O) (see brk{2)). 

HARDWARE DEPENDENCIES 

Series 500: 

End is the lowest heap address available to the user. Etext and Edata are not supported. 
Memallc{2) is more efficient than mo//oc(3C) for setting the program break. 

SEE ALSO 

cc(l), brk(2), malloc(3C), stdio(3S). 
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NAME 

erf, erfc - error function and complementary error function 
SYNOPSIS 

^include <math.h> 

double erf (x) 
double x; 

double erfc (x) 
double x; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

2^2 

Erf returns the error function of a:, defined as — j= f e~^^dt. 

VTT ^ 

Erfc, which returns 1.0 - erf(x), is provided because of the extreme loss of relative accuracy if 
erf(x) is called for large x and the result subtracted from 1.0 (e.g., for j = 5, 12 places are lost). 

SEE ALSO 

exp(3M). 
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NAME 

exp, log, loglO, pow, sqrt - exponential, logarithm, power, square root functions 
SYNOPSIS 


#include <math.h> 


double exp (x) 

float fexp (x) 

double x; 

Jfloat x; 

double log (x) 

float flog (x) 

double x; 

Jfloat x; 

double loglO (x) 

float floglO (x) 

double x; 

Afloat x; 

double pow (x, y) 

float fpow (x,y) 

double X, y; 

Jfloat x,y; 

double sqrt (x) 

float fsqrt (x) 

double x; 

:j;float x; 


t see important note below 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Exp returns e^. 

Log returns the natural logarithm of x. The value of x must be positive. 

LoglO returns the logarithm base ten of x. The value of x must be positive. 

Pow returns x^. If x is zero, y must be positive. If x is negative, y must be an integer. 

Sqrt returns the non-negative square root of x. The value of x may not be negative. 

IMPORTANT NOTE: The corresponding single-precision routines fexp, flog^ floglO, fpow, and 
fsqrt expect true single-precision arguments, and therefore cannot be called from standard C. 
They are provided for support of FORTRAN and Pascal. 

HARDWARE DEPENDENCIES 

Series 200/500: 

The algorithms used are those from HP 9000 BASIC. 

DIAGNOSTICS 

Exp sets errno to ERANGE and returns HUGE when the correct value would overflow, or 0 
when the correct value would underflow. 

Log and loglO return -HUGE and set errno to EDOM when x is non-positive. A message indi¬ 
cating DOMAIN error (or SING error when x is 0) is printed on the standard error output. 

Pow returns 0 and sets errno to EDOM when a: is 0 and y is non-positive, or when x is negative 
and y is not an integer. In these cases a message indicating DOMAIN error is printed on the stan¬ 
dard error output. When the correct value for pow would overflow or underflow, pow returns 
±HUGE or 0 respectively, and sets errno to ERANGE. 

Sqrt returns 0 and sets errno to EDOM when x is negative. A message indicating DOMAIN error 
is printed on the standard error output. 

Error handling is identical for both single- and double-precision routines, except for one con¬ 
sideration: In any situation where the double-precision routine would return ±HUGE, the 
corresponding single-precision routine returns ±MAXFLOAT. 
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These error-handling procedures may be changed with the function matherr{SM). 
SEE ALSO 

hypot(3M), matherr(3M), sinh(3M). 
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NAME 

fclose, fflush - close or flush a stream 
SYNOPSIS 

^include <stdio.h> 

int fclose (stream) 

FILE ^stream; 

int fflush (stream) 

FILE ♦stream; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Fclose causes any buffered data for the named stream to be written out, and the stream to be 
closed. Buffers allocated by the standard input/output system are freed. 

Fclose is performed automatically for all open files upon calling exit (2). 

Fflush causes any buffered data for the named stream to be written to that file. The stream 
remains open. 

DIAGNOSTICS 

These functions return 0 for success, and EOF if any error (such as trying to write to a file that 
has not been opened for writing) was detected. 

SEE ALSO 

close(2), exit(2), fopen(3S), setbuf(3S). 
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NAME 

ferror, feof, clearerr, fileno - stream status inquiries 
SYNOPSIS 

#include <stdio.h> 

int ferror (stream) 

FILE 

♦stream; 

int feof (stream) 

FILE 

♦stream; 

void clearerr (stream) 

FILE 

♦stream; 

int fileno (stream) 

FILE 

♦stream; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Ferror returns non-zero when an I/O error has previously occurred reading from or writing to the 
named stream, otherwise zero. Unless cleared by clearerr, or unless the specific stdio routine so 
indicates, the error indication lasts until the stream is closed. 

Feof returns non-zero when EOF has previously been detected reading the named input stream, 
otherwise zero. 

Clearerr resets the error indicator and EOF indicator to zero on the named stream. 

Fileno returns the integer file descriptor associated with the named stream', see open{2). 

NOTE 

All these functions are implemented as macros; they cannot be declared or redeclared. 

SEE ALSO 

open(2), fopen(3S). 
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NAME 

floor, ceil, fmod, fabs - floor, ceiling, remainder, absolute value functions 

SYNOPSIS 

^include <math.h> 

double floor (x) 
double x; 

double ceil (x) 
double x; 

double fmod (x, y) 
double X, y; 

double fabs (x) 
double x; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Floor returns the largest integer (as a double-precision number) not greater than x. 

Ceil returns the smallest integer not less than x. 

Fmod returns the floating-point remainder of the division of x by y: zero if y is zero or if x/y 
would overflow; otherwise the number / with the same sign as x, such that x = iy + f for some 
integer e, and I /1 < \ y \ . 

Fabs returns the absolute value of a;, I a; I . 

SEE ALSO 

abs(3C). 
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NAME 

fopen, freopen, fdopen - open or re-open a stream file; convert file to stream 
SYNOPSIS 

#include <stdio.h> 

FILE *fopen (file__name, type) 
char *file_name, *type; 

FILE ^freopen (file_name, type, stream) 
char *file_name, *type; 

FILE ^stream; 

FILE *fdopen (fildes, type) 
int fildes; 
char *type; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Fopen opens the file named by file—name and associates a stream with it. Fopen returns a 
pointer to the FILE structure associated with the stream. 

File—name points to a character string that contains the name of the file to be opened. 

Type is a character string having one of the following values: 

"r" open for reading 

"w" truncate or create for writing 

"a" append; open for writing at end of file, or create for writing 

"r+" open for update (reading and writing) 

"w+" truncate or create for update 

"a+" append; open or create for update at end-of-file 

Freopen substitutes the named file in place of the open stream. The original stream is closed, 
regardless of whether the open ultimately succeeds. Freopen returns a pointer to the FILE struc¬ 
ture associated with stream. 

Freopen is typically used to attach the preopened streams associated with stdin, stdout and 
stderr to other files. 

Fdopen associates a stream with a file descriptor. File descriptors are obtained from open, dup, 
creat, or pipe{2), which open files but do not return pointers to a FILE structure stream. Streams 
are necessary input for many of the Section 3S library routines. The type of stream must agree 
with the mode of the open file. 

When a file is opened for update, both input and output may be done on the resulting stream. 
However, output may not be directly followed by input without an intervening /seek or rewind, 
and input may not be directly followed by output without an intervening fseek, rewind, or an 
input operation which encounters end-of-file. 

When a file is opened for append (i.e., when type is "a" or "a+"), it is impossible to overwrite 
information already in the file. Fseek may be used to reposition the file pointer to any position in 
the file, but when output is written to the file, the current file pointer is disregarded. All output 
is written at the end of the file and causes the file pointer to be repositioned at the end of the 
output. If two separate processes open the same file for append, each process may write freely to 
the file without fear of destroying output being written by the other. The output from the two 
processes will be intermixed in the file in the order in which it is written. 
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SEE ALSO 

creat(2), dup(2), open(2), fclose(3S), pipe(2), fclose(3S), fseek(3S), popen(3S). 

DIAGNOSTICS 

Fopen and freopen return a NULL pointer if file-name cannot be accessed, if there are too many 
open files, or if the arguments are incorrect. 

Fdopen returns a NULL if there are too many open files, or if the arguments are ill-formed. 
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NAME 

fread, fwrite - buffered binary input/output to a stream file 
SYNOPSIS 

#include <stdio.h> 

int fread (ptr, size, nitems, stream) 

char *ptr; 

int size, nitems; 

FILE ^stream; 

int fwrite (ptr, size, nitems, stream) 

char *ptr; 

int size, nitems; 

FILE ^stream; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Fread copies, into an array pointed to by ptr, nitems items of data from the named input stream, 
where an item of data is a sequence of bytes (not necessarily terminated by a null byte) of length 
size. Fread stops appending bytes if an end-of-file or error condition is encountered while read¬ 
ing stream, or if nitems items have been read. Fread leaves the file pointer in stream, if defined, 
pointing to the byte following the last byte read if there is one. Fread does not change the con¬ 
tents of stream. 

Fwrite appends at most nitems items of data from the array pointed to by ptr to the named out¬ 
put stream. Fwrite stops appending when it has appended nitems items of data or if an error 
condition is encountered on stream. Fwrite does not change the contents of the array pointed to 
by ptr. 

The argument size is typically sizeof(*ptr) where the pseudo-function sizeof specifies the length of 
an item pointed to by ptr. If ptr points to a data type other than char it should be cast into a 
pointer to char. 

SEE ALSO 

read(2), write(2), fopen(3S), getc(3S), gets(3S), printf(3S), putc(3S), puts(3S), scanf(3S). 
DIAGNOSTICS 

Fread and fwrite return the number of items read or written. If size or nitems is non-positive, no 
characters are read or written and 0 is returned by both fread and fwrite. 
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NAME 

frexp, Idexp, modf - split floating-point into mantissa and exponent 
SYNOPSIS 

double frexp (value, eptr) 
double value; 
int *eptr; 

double Idexp (value, exp) 
double value; 
int exp; 

double modf (value, iptr) 
double value, *iptr; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Every non-zero number can be written imiquely as a;* 2”, where the “mantissa” (fraction) x is in 
the range 0.5 < I a; I < 1.0, and the “exponent” n is an integer. 

Frexp returns the mantissa of a double value, and stores the exponent indirectly in the location 
pointed to by eptr. If value is zero, both results returned by frexp are zero. 

Ldexp returns the quantity value * 2^^^. 

Modf returns the signed fractional part of value and stores the integral part indirectly in the loca¬ 
tion pointed to by iptr. 

DIAGNOSTICS 

If Idexp would cause overflow, ±HUGE is returned (according to the sign of value), and errno is 
set to ERANGE. 

If Idexp would cause underflow, zero is returned and errno is set to ERANGE. 
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NAME 

fseek, rewind, ftell - reposition a file pointer in a stream 
SYNOPSIS 

#include <stdio.h> 

int fseek (stream, offset, ptrname) 

FILE *stream; 
long offset; 
int ptrname; 

long rewind (stream) 

FILE ^stream; 

long ftell (stream) 

FILE ^stream; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Fseek sets the position of the next input or output operation on the stream. The new position is 
at the signed distance offset bytes from the beginning, from the current position, or from the end 
of the file, according as ptrname has the value 0, 1, or 2. 

Rewind{stream) is equivalent to fseek{stream, OL, 0). 

Fseek and rewind undo any effects of ungetc(3S). 

After fseek or rewind, the next operation on a file opened for update may be either input or out¬ 
put. Rewind also does an implicit clearerr{Ss) call. 

Ftell returns the offset of the current byte relative to the beginning of the file associated with the 
named stream. 

SEE ALSO 

lseek(2), fopen(3S), popen(3S), ungetc(3S). 

DIAGNOSTICS 

Fseek returns non-zero for improper seeks, otherwise zero. An improper seek can be, for example, 
an fseek done on a file that has not been opened via fopen] in particular, fseek may not be used 
on a terminal, or on a file opened via popen(3S). 

Ftell returns -1 for error conditions. 

WARNING 

Although on HP-UX an offset returned by ftell is measured in bytes, and it is permissible to seek 
to positions relative to that offset, portability to non-UNIX systems requires that an offset be 
used by fseek directly. Arithmetic may not meaningfully be performed on such an offset, which is 
not necessarily measured in bytes. 
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NAME 

ftw - walk a file tree 

SYNOPSIS 

#include <ftw.h> 

int ftw (path, fn, depth) 
char *path; 
int (*fn) ( ); 
int depth; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Ftw recursively descends the directory hierarchy rooted in path. For each object in the hierarchy, 
ftw calls /n, passing it a pointer to a null-terminated character string containing the name of the 
object, a pointer to a stat structure (see stat(2)) containing information about the object, and an 
integer. Possible values of the integer, defined in the <ftw.h> header file, are FTW__F for a file, 
FTW_D for a directory, FTW_DNR for a directory that cannot be read, and FTW_NS for an 
object for which stat could not successfully be executed. If the integer is FTW_DNR, descendants 
of that directory will not be processed. If the integer is FTW_NS, the stat structure will contain 
garbage. An example of an object that would cause FTW_NS to be passed to fn would be a file in 
a directory with read but without execute (search) permission. 

Ftw visits a directory before visiting any of its descendants. 

The tree traversal continues until the tree is exhausted, an invocation of fn returns a nonzero 
value, or some error is detected within ftw (such as an I/O error). If the tree is exhausted, ftw 
returns zero. If fn returns a nonzero value, ftw stops its tree traversal and returns whatever value 
was returned by fn. If ftw detects an error, it returns -1, and sets the error type in errno. 

Ftw uses one file descriptor for each level in the tree. The depth argument limits the number of 
file descriptors so used. If depth is zero or negative, the effect is the same as if it were 1. Depth 
must not be greater than the number of file descriptors currently available for use. Ftw will run 
more quickly if depth is at least as large as the number of levels in the tree. 

SEE ALSO 

stat(2), malloc(3C). 

BUGS 

Because ftw is recursive, it is possible for it to terminate with a memory fault when applied to 
very deep file structures. 

It could be made to run faster and use less storage on deep structures at the cost of considerable 
complexity. 

Ftw uses malloc{3C) to allocate dynamic storage during its operation. If ftw is forcibly ter¬ 
minated, such as by longjmp being executed by fn or an interrupt routine, ftw will not have a 
chance to free that storage, so it will remain permanently allocated. A safe way to handle inter¬ 
rupts is to store the fact that an interrupt has occurred, and arrange to have fn return a nonzero 
value at its next invocation. 
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NAME 

gamma, signgam - log gamma function 
SYNOPSIS 

#include <math.h> 

double gamma (x) 
double x; 

extern int signgam; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

00 

Gamma returns ln( I r(a:) I ), where r(a:) is defined as The sign of r(a:) is returned 

in the external integer signgam. The argument x may not be a non-positive integer. {Gamma is 
defined over the reals excluding the non-positive integers). 

The following C program fragment might be used to calculate T: 

if ((y = gamma(x)) > LN_MAXDOUBLE) 
error (); 

y = signgam * exp(y); 

where LN_MAXDOUBLE is the least value that causes exp{?M) to return a range error, and is 
defined in the <values.h> header file. 

DIAGNOSTICS 

For non-positive integer arguments HUGE is returned, and errno is set to EDOM. A message 
indicating SING error is printed on the standard error output. 

If the correct value would overflow, gamma returns HUGE and sets errno to ERANGE. 

These error-handling procedures may be changed with the function matherr{SM). 

SEE ALSO 

exp(3M), matherr(3M), values(5). 


Hewlett-Packard 


- 1 - 


July 9, 1985 



GETC(3S) 


GETC(3S) 


NAME 

getc, getchar, fgetc, getw - get character or word from a stream file 
SYNOPSIS 

^include <stdio.h> 

int getc (stream) 

FILE ^stream; 

int getchar () 

int fgetc (stream) 

FILE ^stream; 

int getw (stream) 

FILE ^stream; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Getc returns the next character (i.e., byte) from the named input stream, as an integer. It also 
moves the file pointer, if defined, ahead one character in stream. Getchar is defined as 
getc(stdin). Getc and getchar are macros and so cannot be used if a function is necessary; for 
example one cannot have a function pointer point to them. 

Fgetc behaves like getc, but is a function rather than a macro. Fgetc runs more slowly than getc, 
but it takes less space per invocation and its name can be passed as an argument to a function. 

Getw returns the next word (i.e. int in C) from the named input stream. Getw increments the 
associated file pointer, if defined, to point to the next word. The size- of a word is the size of an 
integer and varies from machine to machine. Getw assumes no special alignment in the file. 

SEE ALSO 

fclose(3S), ferror(3S), fopen(3S), fread(3S), gets(3S), putc(3S), scanf(3S). 

DIAGNOSTICS 

These functions return the constant EOF at end-of-file or upon an error. Because EOF is a valid 
integer, /error (3S) should be used to detect getw errors. 

WARNING 

If the integer value returned by getc, getchar, or fgetc is stored into a character variable and then 
compared against the integer constant EOF, the comparison may never succeed, because sign- 
extension of a character on widening to integer is machine-dependent. 
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BUGS 

Because it is implemented as a macro, getc treats incorrectly a stream argument with side effects. 
In particular, getc(*f++) does not work sensibly. Fgetc should be used instead. 

Because of possible differences in word length and byte ordering, files written using putw are 
machine-dependent, and may not be read using getw on a different (non-HP-UX) processor. 
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NAME 

getcwd - get path-name of current working directory 
SYNOPSIS 

char *getcwd (buf, size) 
char *buf; 
int size; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Getcwd returns a pointer to the current directory path-name. The value of size must be at least 
two greater than the length of the path-name to be returned. 

If 6u/is a NULL pointer, getcwd will obtain size bytes of space using malloc{3C). In this case, the 
pointer returned by getcwd may be used as the argument in a subsequent call to free. 

The function is implemented by using popen(3S) to pipe the output of the 'pwd[l) command into 
the specified string space. 

EXAMPLE 

char *cwd, *getcwd(); 


if {(cwd = getcwd((char *)NULL, 64)) == NULL) { 
perror(“pwd”); 
exit(l); 

} 

printf(“%s\n”, cwd); 

SEE ALSO 

pwd(l), malloc(3C), popen(3S). 

DIAGNOSTICS 

Returns NULL with errno set if size is not large enough, or if an error ocurrs in a lower-level 
function. 
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NAME 

getenv - return value for environment name 
SYNOPSIS 

char *getenv (name) 
char *name; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Getenv searches the environment list (see enmVon(7)) for a string of the form name=value, and 
returns a pointer to the value in the current environment if such a string is present, otherwise a 
NULL pointer. Name may be either the desired name, null-terminated, or of the form 
name=value, in which case getenv uses the portion to the left of the "=" as the search key. 

SEE ALSO 

exec(2), putenv(3C), environ(5). 
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NAME 

getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent - get file system descriptor file entry 

HP-UX COMPATIBILITY 

Level: Large Machine/HP Extension 

Origin: HP and UCB 

SYNOPSIS 

^include <checklist.h> 
struct checklist *getfsent() 

struct checklist *getfsspec(spec) 
char *spec; 

struct checklist *getfsfile(file) 
char *file; 

struct checklist * getfstype (type) 
char *type; 

int setfsent 0 
int endfsent 0 
DESCRIPTION 

Getfsent, getfsspec, getfsfile, and getfstype each return a pointer to an object with the following 
structure containing the broken-out fields off a line in the /etc/checklist file. The structure is 
declared in the <checklist.h> header file: 

struct checklist { 

char *fs_spec; /* special file name */ 
char *fs_bspec; /* block special file name */ 

char *fs_file; /* file sys directory name */ 

char *fs_type; /* type: ro, rw, sw, xx */ 
int fs_passno; /* fsck pass number */ 
int fs_freq; /* backup frequency */ 

}; 

The fields have meanings described in checklist (5). If the block special file name, the file system 
directory name, the type and the pass number are not all defined on the associated line in 
/etc/checklist, these routines will return pointers to NULL in the fs_bspec, fs_file and fs_type 
fields and -1 in the fs_passno field. Fs_freq is reserved for future use. If the fs_freq field is not 
present on the line these routines will return -1 in the fs__freq field. 

Getfsent reads the next line of the file, opening the file if necessary. 

Setfsent opens and rewinds the file. 

Endfsent closes the file. 

Getfsspec and getfsfile sequentially search from the beginning of the file until a matching special 
file name or file system file name is found, or until EOF is encountered. Getfstype does likewise, 
matching on the file system type field. 

FILES 

/etc/checklist 

SEE ALSO 

checklist (5) 

DIAGNOSTICS 

Null pointer (0) returned on EOF, invalid entry or error. 
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BUGS 

All information is contained in a static area so it must be copied if it is to be saved. 
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NAME 

getgrent, getgrgid, getgrnam, setgrent, endgrent, fgetgrent - get group file entry 

SYNOPSIS 

^include <grp.h> 

struct group ♦getgrent ( ) 

struct group ♦getgrgid (gid) 
int gid; 

struct group ♦getgrnam (name) 
char ♦name; 

void setgrent ( ) 
void endgrent ( ) 

struct group ♦fgetgrent (f) 

FILE ♦f; 


HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

Getgrent^ getgrgid and getgrnam each return pointers to an object with the following structure 
containing the broken-out fields of a line in the /etc/group file. Each line contains a “group” 
structure, defined in the <grp.h> header file. 

struct group { 

char ♦gr_name; /♦ the name of the group ♦ / 

char ♦gr—passwd; /♦ the encrypted group password ♦/ 

int gr_gid; /♦ the numerical group ID ♦/ 

char ♦♦gr_mem; /♦ vector of pointers to member names ♦/ 

}; 

Getgrent when first called returns a pointer to the first group structure in the file; thereafter, it 
returns a pointer to the next group structure in the file; so, successive calls may be used to search 
the entire file. Getgrgid searches from the beginning of the file until a numerical group id match¬ 
ing gid is found and returns a pointer to the particular structure in which it was found. Get¬ 
grnam searches from the beginning of the file until a group name matching name is found and 
returns a pointer to the particular structure in which it was found. If an end-of-file or an error is 
encountered on reading, these functions return a NULL pointer. 

A call to setgrent has the effect of rewinding the group file to allow repeated searches. Endgrent 
may be called to close the group file when processing is complete. 

Fgetgrent returns a pointer to the next group structure in the stream /, which matches the format 
of /etc/group. 

FILES 

/etc/group 


SEE ALSO 

getlogin(3C), getpwent(3C), group(5). 

DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 

WARNING 

The above routines use <stdio.h>, which causes them to increase the size of programs, not oth¬ 
erwise using standard I/O, more than might be expected. 
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BUGS 

All information is contained in a static area, so it must be copied if it is to be saved. 
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NAME 

getlogin - get login name 

SYNOPSIS 

char *getlogin ( ); 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

Getlogin returns a pointer to the login name as found in /etc/utmp. It may be used in conjunc¬ 
tion with getpwnam to locate the correct password file entry when the same user ID is shared by 
several login names. 

If getlogin is called within a process that is not attached to a terminal, it returns a NULL pointer. 
The correct procedure for determining the login name is to call cuserid, or to call getlogin and if it 
fails to call getpwuid. 

FILES 

/etc/utmp 
SEE ALSO 

cuserid(3S), getgrent(3C), getpwent(3C), utmp(5). 

DIAGNOSTICS 

Getlogin returns the NULL pointer if name is not found. 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

getmsg - get message from a catalog 
SYNOPSIS 

char *getmsg (fd, set_Qiim, msg_num, buf, buflen) 
int fd, set_Qum, msg__Qmn, buflen; 
char buf[]; 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Native Language Support: 

8-bit data, customs, messages 

DESCRIPTION 

Getmsg attempts to read up to buflen-1 bytes of a message string into the area pointed to by buf. 

A null byte is inserted to terminate the string placed in the buffer. 

Fd is the file descriptor returned by a call to open(2) the catalog containing the messages. 
Set—uum is available to group messages together into a logical unit. For instance, messages in 
Finnish could be grouped in set number 6 to match the language id for Finnish (See 
currlangid(SC) and langid(l)). 

DIAGNOSTICS 

Returns a pointer to an empty (null) string if fd is invalid or set—Uum or msg^num is not in the I 
catalog. 

SEE ALSO 

gencat(l), insertmsg(l), read(2), hpnls(7). 
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NAME 

getopt, optarg, optind, opterr - get option letter from argument vector 
SYNOPSIS 

int getopt (argc, argv, optstring) 
int argc; 

char **argv, *opstring; 

extern char *optarg; 
extern int optind, opterr; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Getopt returns the next option letter in argv (starting from argvfl]) that matches a letter in opt¬ 
string. Optstring is a string of recognized option letters; if a ieitei is followed by a colon, the 
option is expected to have an argument that may or may not be separated from it by white space. 
Optarg is set to point to the start of the option argument on return from getopt. 

Getopt places in optind the argv index of the next argument to be processed. Because optind is 
external, it is normally initialized to zero automatically before the first call to getopt. 

When all options have been processed (i.e., up to the first non-option argument), getopt returns 
EOF. The special option -- may be used to delimit the end of the options; EOF will be returned, 
and — will be skipped. 

DIAGNOSTICS 

Getopt prints an error message on stderr and returns a question mark (?) when it encounters an 
option letter not included in optstring. This error message may be disabled by setting opterr to 
zero. 

WARNING 

The above routine uses <stdio.h>, which causes it to increase the size of programs, not otherwise 
using standard I/O, more than might be expected. 

Options can be any ASCII characters except colon (:), question mark (?), or null (\0). It is 
impossible to distinguish between a ? used as a legal option, and the character that getopt returns 
when it encounters an invalid option character in the input. 

EXAMPLE 

The following code fragment shows how one might process the arguments for a command that can 
take the mutually exclusive options a and b, and the options f and o, both of which require argu¬ 
ments: 

main (argc, argv) 
int argc; 
char >K*argv; 

{ 

int c; 

extern char *optarg; 
extern int optind; 


while ((c = getopt(argc, argv, "abf:o:")) != EOF) 
switch (c) { 
case ’a’: 

if (bflg) 

errflg++; 
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else 

aflg++; 

break; 

case ’b’: 

if (aflg) 

errflg++; 

else 

bproc( ); 

break; 

case ’f: 

ifile = optarg; 
break; 

case ’o’: 

ofile = optarg; 
break; 

case ’?’: 

errflg++; 

} 

if (errflg) { 

fprintf(stderr, "usage: . . . "); 
exit (2); 

} 

for ( ; optind < argc; optind++) { 
if (access(argv[optind], 4)) { 


} 

SEE ALSO 

getopt(l). 


Hewlett-Packard 


-2- 


July 2, 1985 



GETPASS(3C) 


GETPASS(3C) 


NAME 

getpass - read a password 

SYNOPSIS 

char *getpass (prompt) 
char ^prompt; 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

Getpass reads up to a newline or EOF from the file /dev/tty, after prompting on the standard 
error output with the null-terminated string prompt and disabling echoing. A pointer is returned 
to a null-terminated string of at most 8 characters. If /dev/tty cannot be opened, a NULL 
pointer is returned. An interrupt will terminate input and send an interrupt signal to the calling 
program before returning. 

FILES 

/dev/tty 

SEE ALSO 

crypt (3C). 

WARNING 

The above routine uses <stdio.h>, which causes it to increase the size of programs not otherwise 
using standard I/O, more than might be expected. 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

getpw - get name from UID 
SYNOPSIS 

int getpw (uid, buf) 
int uid; 
char *buf; 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

Getpw searches the password file for a user id number that equals uid, copies the line of the pass¬ 
word file in which uid was found into the array pointed to by buf, and returns 0. Getpw returns 
non-zero if uid cannot be found. The line is null-terminated. 

This routine is included only for compatibility with prior systems and should not be used; see 
getpwent{3C) for routines to use instead. 

FILES 

/etc/passwd 

SEE ALSO 

getpwent(3C), passwd(5). 

DIAGNOSTICS 

Getpw returns non-zero on error. 

WARNING 

The above routine uses <stdio.h>, which causes it to increase, more than might be expected, the 
size of programs not otherwise using standard I/O. 
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NAME 

getpwent, getpwuid, getpwnam, setpwent, endpwent, fgetpwent - get password file entry 

SYNOPSIS 

^include <pwd.h> 

struct passwd *getpwent ( ) 

struct passwd *getpwuid (uid) 
int uid; 

struct passwd *getpwnam (name) 
char *name; 

void setpwent ( ) 
void endpwent ( ) 

struct passwd *fgetpwent (f) 

FILE *f; 


HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

Getpwent, getpwuid and getpwnam each returns a pointer to an object with the following struc¬ 
ture containing the broken-out fields of a line in the /etc/passwd file. Each line in the file con¬ 
tains a “passwd” structure, declared in the <pwd.h> header file: 


struct 


}; 

struct 


}; 


passwd { 

char 

*pw__name; 

char 

*pw_passwd; 

int 

pw_uid; 

int 

pw_gid; 

char 

*pw_age; 

char 

*pw_comment; 

char 

*pw_gecos; 

char 

*pw_dir; 

char 

*pw_shell; 

comment { 

char 

*c_dept; 

char 

*c_name; 

char 

*c_acct; 

char 

*c_bin; 


This structure is declared in <pwd.h> so it is not necessary to redeclare it. 


The pw—comment field is unused; the others have meanings described in passwd{b). 


Getpwent when first called returns a pointer to the first passwd structure in the file; thereafter, it 
returns a pointer to the next passwd structure in the file; so successive calls can be used to search 
the entire file. Getpwuid searches from the beginning of the file until a numerical user id match¬ 
ing uid is found and returns a pointer to the particular structure in which it was found. 
Getpwnam searches from the beginning of the file until a login name matching name is found, and 
returns a pointer to the particular structure in which it was found. If an end-of-file or an error is 
encountered on reading, these functions return a NULL pointer. 

A call to setpwent has the effect of rewinding the password file to allow repeated searches. 
Endpwent may be called to close the password file when processing is complete. 
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Fgetpwent returns a pointer to the next passwd structure in the stream /, which matches the for¬ 
mat of /etc/passwd. 

FILES 

/etc/passwd 
SEE ALSO 

getlogin(3C), getgrent(3C), passwd(4). 

DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 

WARNING 

The above routines use <stdio.h>, which causes them to increase the size of programs, not oth¬ 
erwise using standard I/O, more than might be expected. 

BUGS 

All information is contained in a static area, so it must be copied if it is to be saved. 
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NAME 

gets, fgets - get a string from a stream 
SYNOPSIS 

^include <stdio.h> 

char *gets (s) 
char *s; 

char *fgets (s, n, stream) 
char *s; 
int n; 

FILE ^stream; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Gets reads characters from the standard input stream, stdin, into the array pointed to by s, until 
a new-line character is read or an end-of-file condition is encountered. The new-line character is 
discarded and the string is terminated with a null character. 

Fgets reads characters from the stream into the array pointed to by s, until rz-1 characters are 
read, or a new-line character is read and transferred to 5, or an end-of-file condition is encoun¬ 
tered. The string is then terminated with a null character. 

SEE ALSO 

ferror(3S), fopen(3S), fread(3S), getc(3S), puts(3S), scanf(3S). 

DIAGNOSTICS 

If end-of-file is encountered and no characters have been read, no characters are transferred to s 
and a NULL pointer is returned. If a read error occurs, such as trying to use these functions on a 
file that has not been opened for reading, a NULL pointer is returned. Otherwise s is returned. 
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NAME 

getutent, getutid, getutline, pututline, setutent, endutent, utmpname - access utmp file entry 
SYNOPSIS 

#include <types.h> 

^include <utmp.h> 

struct utmp *getutent ( ) 

struct utmp *getutid (id) 
struct utmp ♦id; 

struct utmp ♦getutline (line) 
struct utmp ♦line; 

void pututline (utmp) 
struct utmp ♦utmp; 

void setutent ( ) 
void endutent ( ) 

void utmpname (file) 
char ♦file; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Getutent^ getutid and getutline each return a pointer to a structure of the following type: 

struct utmp { 
char 
char 
char 
short 
short 
struct 
short 
short 
} ut_exit; 

time_t 

}; 

Getutent reads in the next entry from a «<mp-like file. If the file is not already open, it opens it. 
If it reaches the end of the file, it fails. 

Getutid searches forward from the current point in the utmp file until it finds an entry with a 
ut—type matching id->ut—type if the type specified is RUN_LVL, BOOT_TIME, OLD_TIME or 
NEW_TIME. If the type specified in id is INIT_PROCESS, LOGIN-PROCESS, USER—PROCESS or 
DEAD-PROCESS, then getutid will return a pointer to the first entry whose type is one of these 
four and whose ut—id field matches id->ut—id. If the end of file is reached without a match, it 
fails. 

Getutline searches forward from the current point in the utmp file until it finds an entry of the 
type LOGIN-PROCESS or USER—PROCESS which also has a ut-Jine string matching the 
line->ut—line string. If the end of file is reached without a match, it fails. 

Pututline writes out the supplied utmp structure into the utmp file. It uses getutid to search for¬ 
ward for the proper place if it finds that it is not already at the proper place. It is expected that 


ut—user[8]; /♦ User login name */ 

ut—id[4]; /♦ /etc/inittab id (usually line #) */ 

ut—Iine[12]; /♦ device name (console, Inxx) ♦/ 

ut—pid; /♦ process id ♦/ 

ut—type; /♦ type of entry ♦/ 

exit—status { 

e—termination; /♦ Process termination status ♦/ 
e—exit; /♦ Process exit status ♦/ 

/♦ The exit status of a process 
♦ marked as DEAD—PROCESS. ♦/ 
ut—time; /* time entry was made */ 
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normally the user of pututline will have searched for the proper entry using one of the getut rou¬ 
tines. If so, pututline will not search. If pututline does not find a matching slot for the new entry, 

it will add a new entry to the end of the file. 

Setutent resets the input stream to the beginning of the file. This should be done before each 
search for a new entry if it is desired that the entire file be examined. 

Endutent closes the currently open file. 

Utmpname allows the user to change the name of the file examined, from /etc/utmp to any 
other file. It is most often expected that this other file will be /etc/v^tmp. If the file does not 

exist, this will not be apparent until the first attempt to reference the file is made. Utmpname 

does not open the file. It just closes the old file if it is currently open and saves the new file name. 

FILES 

/etc/utmp 

/etc/wtmp 

SEE ALSO 

ttyslot(3C), utmp(4). 

DIAGNOSTICS 

A NULL pointer is returned upon failure to read, whether for permissions or having reached the 
end of file, or upon failure to write. 

COMMENTS 

The most current entry is saved in a static structure. Multiple accesses require that it be copied 
before further accesses are made. Each call to either getutid or getutline sees the routine examine 
the static structure before performing more I/O. If the contents of the static structure match 
what it is searching for, it looks no further. For this reason to use getutline to search for multiple 
occurrences, it would be necessary to zero out the static after each success, or getutline would just 
return the same pointer over and over again. There is one exception to the rule about removing 
the structure before further reads are done. The implicit read done by pututline (if it finds that it 
is not already at the correct place in the file) will not hurt the contents of the static structure 
returned by the getutent^ getutid or getutline routines, if the user has just modified those contents 
and passed the pointer back to pututline. 

These routines use buffered standard I/O for input, but pututline uses an unbuffered non-standard 
write to avoid race conditions between processes trying to modify the utmp and wtmp files. 
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NAME 

gpio_get_status - return status lines of GPIO card 

SYNOPSIS 

int gpio_get_status (eid) 
int eid; 

HP-UX GOMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Gpio—get—status enables you to read the status register of the GPIO interface associated with the 
device file identified by eid. Eid is an entity identifier of an open GPIO device file obtained from 
an open{2), dup{2), fcntl{2), or creat[2). The current state of each status line on the interface 
card is mapped to the value returned, with STSO mapped to the least significant bit. Only x 
least-significant bits are used, where x is the number of status lines available on the hardware 
interface being used. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

For the current GPIO card, a: is 2. 

RETURN VALUE 

Gpio—get^status returns the value of the status register of the GPIO interface associated with eid, 
and -1 if an error was encountered. 

DIAGNOSTICS 

Gpio—get—status fails under the following conditions and sets errno (see errno(2)) to the value in 
square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to a GPIO device file [ENOTTY]. 
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NAME 

gpio_set_ctl - set control lines on GPIO card 
SYNOPSIS 

int gpio__set_ctl (eid, value) 
int eid, value; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Gpioset^ctl enables you to set the control register of a GPIO interface. Eid is an entity 
identifier of an open GPIO device file obtained from an open{2), dup{2), fcntl{2), or creat{2) call. 
Value is the value to be written into the control register of the GPIO interface associated with eid. 

Value is mapped onto the control lines on the interface card, with the least significant bit mapped 
to CTLO. Only the x least significant bits are used, where x is the number of control lines avail¬ 
able on the hardware interface being used. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

For the current GPIO card, x is 2. 

RETURN VALUE 

Gpio—set—ctl returns 0 if successful, and -1 if an error was encountered. 

DIAGNOSTICS 

Gpio—set—ctl fails under the following circumstances and sets errno (see errno{2)) to the value in 
square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to a GPIO device file [ENOTTY]. 
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NAME 

hpib_abort - stop activity on specified HP-IB bus 
SYNOPSIS 

int hpib_abort (eid); 
int eid; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpih—abort terminates activity on the addressed HP-IB bus by pulsing the IFC line. Eid is an 
entity identifier of an open HP-IB raw bus device file obtained from an open{2)^ dup(2), fcntl{2), 
or Great(2) call. 

Hpib—abort also sets the REN line and clears the ATN line. The status of the SRQ line is not 
affected. The interface must be the system controller of the bus. 

RETURN VALUE 

Hpib—abort returns 0 (zero) if successful, or -1 if an error was encountered. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

DIAGNOSTICS 

Hpib—abort fails under the following circumstances, and sets errno (see errno{2)) to the value in 
square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [KNOTTY]; 

the specified interface is not the system controller [ElOj. 
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NAME 

hpib_bus_status - return status of HP-IB interface 
SYNOPSIS 

int hpib_bus_status (eid, status); 
int eid, status; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpib—bus—.status enables you to determine selected status information about an HP-IB chan¬ 
nel. Eid is an entity identifier of an open HP-IB raw bus device file obtained from an open(2), 
dup{2), fcntl{2), or creat{2) call. Status is an integer determining what status information is 
returned for a particular call. The values defined for status and their associated meanings are: 

Value Meaning 

0 Is the channel currently in remote state? 

1 What is the current state of the SRQ line? 

2 What is the current state of the NDAC line? 

3 Is the channel currently system controller? 

4 Is the channel currently active controller? 

5 Is the channel currently addressed as talker? 

6 Is the channel currently addressed as listener? 

7 What is the channel’s bus address? 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

A bug in the HP27110A HP-IB interface causes an erroneous report of the state of the 
SRQ line. There is a small window when hpib—busstatus{e\d, 1) reports that the SRQ 
line is clear when in reality it is set. OR-ing together five successive readings of the 
state of the SRQ line yields a reading of about 99% accuracy. 

The remote state status is not defined when the interface is the active controller, 
although reading remote state status in such a situation is not an error. 

Series 200/300: 

The status of those lines being driven by the interface is undefined, although reading 
them in such a situation is not an error. Non-active controllers cannot sense the SRQ 
line. Active listeners cannot sense the NDAC line. 

RETURN VALUE 

Hpib—bus—status's return value depends upon the value of status, as follows: 


Status 

Return Value 

Meaning 

— 

-1 

Error condition. 

0-6 

0 

False condition (line is clear). 

0-6 

1 

True condition (line is set). 

7 

0-30 

Bus address of interface card. 
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DIAGNOSTICS 

Hpib—husstatus fails under the following conditions, and sets errno (see errno{2)) to the value in 
square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [ENOTTY]; 

status is outside the range [0-7] [EINVALj. 
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NAME 

hpib_card_ppoll__resp - control response to parallel poll on HP-IB 

SYNOPSIS 

int hpib_card_ppoll_resp (eid,flag); 
int eidjflag; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpib-card—ppolL-resp enables an interface to enable (or disable) itself for parallel polls. It 
also controls the sense, and determines the line on which the response is sent. This gives the 
interface the ability to either ignore or respond to a parallel poll depending upon whether or 
not it is enabled to respond. 

Eid is an entity identifier of an open HP-IB raw bus device file obtained from an open{2), dup{2), 
fcntl{2), or creat(2) call. Flag is an integer having one of the following bit patterns: 

Bit Pattern Meaning 

10000 Disable parallel poll response. 

OSPPP Enable parallel poll response, where 

S = sense of the response, and 

PPP = 3-bit binary number specifying the line on which the 
response is sent (0-7 octal). 

HARDWARE DEPENDENCIES 

Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

Note that the HP 27110A/B HP-IB interface cards do not support programmatic parallel 
poll response configuration. 

RETURN VALUE 

Hpib-card-^ppolL-resp returns 0 (zero) if successful, or -1 if an error was encountered. 

SEE ALSO 

hpib_ppoll(3I) and hpib_ppoll_resp_ctl(3I). 

DIAGNOSTICS 

Hpib—card—ppoU^resp fails under the following circumstances, and sets errno (see errno[2)) to 
the value in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [ENOTTY); 
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NAME 

hpib_eoi_ctl - control EOI mode for HP-IB file 
SYNOPSIS 

int hpib_eoi_ctl (eid, flag); 
int eid, flag; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpib—eoi—ctl enables you to turn EOI mode on or off. Eid is an entity identifier of an open HP-IB 
raw device file obtained from an open(2), dup(2), fcntl(2), or creat{2) call. Flag is an integer 
which, if non-zero, enables EOI mode, and otherwise disables it. 

EOI mode causes the last byte of all subsequent write operations to be written out with the EOI 
line asserted, signifying the end of the data transmission. By default, EOI mode is disabled when 
the device file is opened. 

Entity ids for the same device file obtained by separate open{2) requests have their own EOI 
modes associated with them. Entity ids for the same device file obtained by dup{2) or inherited 
by a fork{2) request share the same EOI mode. In the latter case, if one process enables EOI 
mode, then EOI mode is in effect for all such file descriptors. 

RETURN VALUE 

Hpib—eoi—ctl returns a 0 (zero) if successful, or -1 if an error was encountered. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

DIAGNOSTICS 

Hpib—eoL^ctl fails under any of the following circumstances and sets errno (see errno{2)) to the 
value in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB device file [ENOTTY]. 
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NAME 

hpib_io - perform I/O with an HP-IB channel from buffers 
SYNOPSIS 

^include <dvio.h> 

int hpib_io(eid, iovec, iolen) 

int eid; 

struct iodetail *iovec; 
int iolen; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpib—io enables you to perform and control read and/or write operations on the specified HP-IB 
bus. Eid is an entity identifier of an open HP-IB raw bus device file obtained from an open(2), 
dup{2), fcntl{2), or creat{2) call. Iovec is a pointer to an array of structures of the form: 

struct iodetail { 

char mode; 
char terminator; 
int count; 
char *buf; 

}; 

The iodetail structure is defined in the include file libdvio.h. Iolen specifies the number of struc¬ 
tures in iovec. 

The mode parameter in the iodetail structure describes what is to be done during I/O on the 
buffer pointed to by buf. Mode is constructed by OR-ing flags from the following list: 

Only one of the following two flags must be specified: 

HPIBREAD Perform a read of the HP-IB bus, placing data into the accompanying 

buffer. 

HPIBWRITE Perform a write to the HP-IB bus, using data from the accompanying 

buffer. 

The following flags may be used in most combinations (not all combinations are valid), or 
not at all: 

HPIBATN Data is written with ATN enabled. 

HPIBEOI Data written is terminated with EOI (this flag is ignored when HPI¬ 

BATN is enabled). 

HPIBCHAR Data read is terminated with the character given in the terminator 

element of the iodetail structure. 

Terminator describes the termination character, if any, that should be checked for on input. 
Count is an integer specifying the maximum number of bytes to be transferred. 

A read operation terminates when either count is matched, an EOI is detected, or the desig¬ 
nated terminator is detected (if HPIBCHAR is set in mode). 

A write operation terminates when count is matched, and the final byte is sent with EOI asserted 
(if HPIBEOI is set in mode). 

If HPIBATN is set in mode, then write operations occur with ATN enabled. Setting HPIBATN for 
a read operation is ignored and has no effect. 
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The members of the iovec array are accessed in order. 

RETURN VALUES 

If all transactions are successful, hpih—io returns a zero and updates the count element in each 
structure in the iovec array to reflect the actual munber of bytes read or written. 

If an error is encoimtered during a transaction defined by an element of iovec^ hpib—io 
returns without completing any transactions that might follow. In particular, if an error occurs, 
hpib—io returns a -1, and the count element of the transaction which caused the error is set to -1. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

DIAGNOSTICS 

Hpib—io fails under any of the following circumstances, and sets errno (see errno{2)) to the value 
in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [ENOTTY]; 

a timeout occurs [EIO]; 

eid is not the active controller [EIO]. 
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NAME 

hpib_pass_ctl - change active controllers on HP-IB 
SYNOPSIS 

int hpib_pass_ctl (eid, ba) 
int eid, ba; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpib—pass—ctl passes control of a bus to an inactive controller on that bus. The inactive con¬ 
troller becomes the active controller of that bus. Eid is an entity identifer of an open HP-IB raw 
bus device file obtained from an open{2), dup{2), fcntl{2), or creat[2) call. Ba is the bus address 
of the intended device. 

Not all devices can accept control. Pass control passes only active control of the bus. It cannot 
pass system control of the bus. The specified interface must be the current active controller 
but need not be the system controller. The pass control operation does not suspend your pro¬ 
gram if the inactive controller does not take active control of the bus. However, the interface is 
no longer active controller. 

RETURN VALUE 

Hpib—pass—ctl returns 0 (zero) if successful, or -1 if an error was encountered. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

DIAGNOSTICS 

Hpib—pass—ctl fails under any of the following circumstances, and sets errno (see errno{2)) to the 
value in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [ENOTTY]; 

the interface is not the active controller [EIO]; 

ba does not refer to a valid bus address [EINVAL]. 
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NAME 

hpib—ppoll - conduct parallel poll on HP-IB bus 
SYNOPSIS 

int hpib_ppoll (eid); 
int eid; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpib—ppoH conducts a parallel poll on an HP-IB bus. eid is a file descriptor of an open HP-IB raw 
bus device file obtained from an open(2), dwp(2), fcntl(2), or creat{2) call. 

Devices enabled to respond and that are in need of service can then assert the appropriate DIO 
line. This enables the controller to determine which devices, if any, need service at a given time. 
Hpib—ppoll raises attention (ATN) and end or identify (EOI) lines for 25 microseconds before 
reading the response. The interface must be the active controller to conduct a parallel poll. 

RETURN VALUE 

Hpib—ppoll returns an integer value whose least significant byte corresponds to the byte formed 
by the 8 data input/output (DIO) lines. Devices enabled to respond to a parallel poll do so on 
the appropriate DIO line. DIO line 0 corresponds to the least significant bit in the response 
byte. A -1 return value indicates that an error occurred. 

HARDWARE DEPENDENCIES 

Series 200/300/500 

Eid is an integer file descriptor (hides) that identihes an open device special hie. 

DIAGNOSTICS 

Hpib—ppoll fails imder the following situations, and sets errno (see errno[2)) to the value in 
square brackets: 

eid does not refer to an open hie [EBADF]; 

eid does not refer to an HP-IB raw bus device hie [ENOTTY]; 

the interface is not current the active controller [EIO]. 
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NAME 

hpib_ppoll_resp_ctl - Define interface parallel poll response 
SYNOPSIS 

int hpib—ppoll_resp_ctl (eid, response) 

int eid, response; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Eid is an entity identifier of an open HP-IB raw bus device file, obtained from an open(2), dup{2), 
fcntl{2)^ or creat{2) call. 

Hpib-ppolL-resp^ctl defines a response to be sent when an active controller performs a parallel 
poll on an HP-IB interface. The value of response indicates whether this computer does or does 
not need service. A non-zero response value indicates that service is required. This statement only 
sets up a potential response; no actual response if generated when the statement is executed. The 

sense of the response and the line number to respond on are set by hpib _ card—ppolL—resp{2>) or 

by the active controller. When first opened, the default response and sense are 0. 

RETURN VALUE 

Hpib^ppolLjresp—ctl returns 0 if the response is successfully set, or -1 if an error has occured. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

DIAGNOSTICS 

Hpib—.ppoil—resp—ctl fails under the following situations, and sets errno (see errno{2)) to the 
value in square brackets: 

eid does not refer to an open file [EBADF] 

eid does not refer to a raw HP-IB device file [ENOTTY] 

SEE ALSO 

hpib_ppoll(3I), hpib—card_^ppoll__resp(3I) 
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NAME 

hpib—ren_ctl - control the Remote Enable line on HP-IB 

SYNOPSIS 

int hpib_ren_ctl (eid, flag); 
int eid, flag; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpib—ren—ctl enables/disables the Remote Enable (REN) line depending upon the value of 
flag. Eid is an entity identifer of an open HP-IB raw bus device file obtained from an open (2), 
dup2), fcntl{2),or creat{2)calL Flag is an integer which, if non-zero, enables the REN line, and 
otherwise disables it. 

Hpib—ren—ctl, in conjunction with hpib—send—cmnd{3), enables you to place devices into the 
remote state or local state. The REN line is normally enabled at all times, and is in this state at 
power-up. Only the system controller may enable/disable the REN line. 

RETURN VALUE 

Hpib—reri—ctl returns 0 (zero) if successful, or -1 if an error was encountered. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (hides) that identihes an open device special hie. 

DIAGNOSTICS 

Hpib—ren—ctl fails under the following circumstances, and sets errno (see errno(2)) to the value 
in square brackets: 

eid does not refer to an open hie [EBADF]; 

eid does not refer to an HP-IB raw bus device hie [ENOTTY]; 

the interface is not the system controller [EIO]. 
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NAME 

hpib_rqst_srvce - allow interface to enable SRQ line on HP-IB 
SYNOPSIS 

int hpib_jrqst_srvce (eid, cv); 
int eid, cv; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpib—rqst—srvce specifies the response byte that the interface sends when it is serially polled 
by the active controller. Eid is an entity identifier of an open HP-IB raw bus device file obtained 
from an open{2), dup{2), fcntl{2), or creat{2) call. Cv is an integer control value representation of 
the desired response byte. 

Hpib—rqst—srvce optionally enables the SRQ line depending upon the response byte. If bit 6 of the 
response byte is set, the SRQ line is enabled. It remains enabled until the active controller con¬ 
ducts a serial poll or until the computer executes the request function with bit 6 cleared. The 
SRQ line is not enabled, however, as long as the interface is active controller. If bit 6 is set, the 
interface remembers its response byte, and enables the SRQ line when control is passed to another 
device on the bus. 

The response byte looks as follows: 

Bit Meaning 

0 SPOLL bit (least significant bit of response byte) 

1 SPOLL bit 

2 SPOLL bit 

3 SPOLL bit 

4 SPOLL bit 

5 SPOLL bit 

6 SRQ line 

7 SPOLL bit (most significant bit of response byte) 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

Note that the HP 27110A/B HP-IB interface cards allow only bit 6 to be set. All other 
bits remain cleared. 

RETURN VALUE 

Hpib—rqst—srvce returns 0 (zero) if successful, or -1 if an error was encountered. 

DIAGNOSTICS 

Hpib—rqstsrvce fails under the following circumstances, and sets errno (see errno{2)) to the 
value in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [ENOTTY]. 
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NAME 

hpib__send_cmnd - send command bytes over HP-IB 

SYNOPSIS 

int hpib_send_cmnd (eid, ca, length); 

int eid, length; 
char *ca; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpibsend—cmnd enables you to send arbitrary bytes of information on the HP-IB with the ATN 
line asserted. This enables you to configure and control the bus. Eid is an entity identifier of 
an open HP-IB raw bus device file obtained from an open (2), dup{2), fcntl(2), or creat(2) call. Ca 
is a character pointer to a string of bytes to be written to the HP-IB bus as commands. Length is 
an integer specifying the number of bytes in the string pointed to by ca. 

The interface must currently be the active controller in order to send commands over the 
bus. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Note that, for all HP-IB interfaces, both built-in and plug-in, the most significant bit of 
each byte is overwritten with a parity bit. All commands are written with odd parity. 

RETURN VALUE 

Hpibsend—cmnd returns 0 (zero) if successful, or -1 if an error was encountered. 

DIAGNOSTICS 

Hpibsend—cmnd fails under the following circumstances, and sets errno (see errno{2)) to the 
value in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [ENOTTY]; 

the interface is not currently the active controller [EIO]. 
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NAME 

hpib—spoll - conduct a serial poll on HP-IB bus 
SYNOPSIS 

int hpib_spoil (eid, ba); 

int eid, ba; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpibspoll conducts a serial poll of the specified device. Eid is an entity identifier of an open HP¬ 
IB raw bus device file obtained from an open{2), dup{2), fcntl{2), or creat{2) call. Ba is the bus 
address of the intended device. 

Hpibspoll polls a single device for its response byte. The information stored in the response 
byte is device specific with the exception of bit 6. If bit 6 of the response byte is set, the 
addressed device has asserted the SRQ line, and is requesting service. (Note that the least 
significant (right-most) bit of the response byte is bit 0.) 

Not all devices respond to the serial poll function. Consult the device documentation. Specifying 
a device that does not support serial polling may cause a timeout error or suspend your pro¬ 
gram indefinitely (see hpib—rqst—srvce[Z)). The interface cannot serial poll itself. The inter¬ 
face must be the active controller. 

RETURN VALUE 

If hpibspoll is successful, the device response byte is returned in the least significant byte of the 
return value. Otherwise, -1 is returned, indicating an error. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

SEE ALSO 

hpib__rqst_srvce (31). 

DIAGNOSTICS 

Hpibspoll fails under the following circumstances, and sets errno (see errno(2)) to the value in 
square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [ENOTTY]; 

the device polled did not respond before timeout, or the interface is not the active con¬ 
troller [EIO]; 

ba is the address of the polling interface itself or is an invalid bus address [EINVAL]. 
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NAME 

hpib^tatus—wait - wait until the requested status condition becomes true 
SYNOPSIS 

int hpib_status_wait (eid, status); 
int eid,status; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpihstatus—wait enables you to wait until a specific condition has occurred before returning. 
Eid is an entity identifier of an open HP-IB raw bus device file obtained from an open (2), dup{2), 
fcntl{2), or creat{2) call. Status is an integer specifying what information is returned. The possi¬ 
ble values for status and their associated meanings are: 

Status Meaning 

1 Wait until the SRQ line is enabled. 

4 Wait until this channel is the active controller. 

5 Wait until this channel is addressed as talker. 

6 Wait until this channel is addressed as listener. 

The wait is subject to the current timeout in effect. If a timeout occurs before the desired condi¬ 
tion occurs, the function returns with an error. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

When an hpip_status—wait is in progress, all other bus activity is held off until it has 
completed. Therefore, it is strongly recommended that a timeout be in effect before all 
hpib—status^wait calls. 

RETURN VALUE 

Hpih—status—wait returns zero when the condition requested becomes true. A value of -1 is 
returned if an error occurs. A -1 is also returned if a timeout occurs before the desired condition 
becomes true. 

DIAGNOSTICS 

Hpib—status—wait fails under the following circumstances, and sets errno (see errno(2)) to the 
value in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [ENOTTY]; 

a timeout occured [EIO]; 

status contains an invalid value [EINVAL]. 
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NAME 

hpib_wait_on_ppoll - wait until a particular parallel poll value occurs 

SYNOPSIS 

int hpib_wait_on_ppoll (eid, mask, sense); 
int eid, mask, sense; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Hpib—wait—071—ppoll waits for a parallel poll response to occur on one or more lines. Eid is an 
entity identifier of an open HP-IB raw bus device file obtained from an open{2)^ dup{2), fcntl{2), or 
creat{2) call. 

Mask is an integer that specifies on which line the parallel poll response is expected. Mask's value 
is obtained from an 8-bit binary number, each bit of which corresponds to one of the eight lines. 
For example, if you want to wait for a response on lines 2 or 6, the correct binary number is 
01000100. This converts to a decimal equivalent of 68, which is the number you should assign to 
mask. 

Sense simply specifies what response you are expecting on the selected lines. Sense is constructed 
in the same way as mask - eight bits for eight lines. If a bit is set, then the function returns when 
the line corresponding that bit is cleared. Similarly, if a bit in sense is clear, the function returns 
when the corresponding line is set. Using the previous example, a sense = 00000100 = 4 
(decimal) causes the function to return when line 6 is set, and return when line 2 is cleared. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

When an hpih—wait—on—ppoll is in progress, all other bus activity is held off until it has 
completed. Therefore, it is strongly recommended that a timeout be in effect before all 
hpib _ wait—on—ppoll calls. 

RETURN VALUE 

Hpib—wait—on—ppoll returns a value of -1 if an error or timeout condition occurs. A successful 
completion of the function returns the response byte XOR-ed with the sense value and AND-ed 
with the mask. 

DIAGNOSTICS 

Hpib—wait—on—ppoll fails under the following circumstances, and sets errno (see errno[2)) to the 
value in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [ENOTTY]; 

a timeout occured [EIO]; 

the interface is not currently the active controller [EIO). 


- 1- 


Hewlett-Packard 


November 15, 1985 



HSEARCH(3C) 


HSEARCH(3C) 


NAME 

hsearch, hcreate, hdestroy - manage hash search tables 
SYNOPSIS 

#include <search.h> 

ENTRY *hsearch (item, action) 

ENTRY item; 

ACTION action; 

int hcreate (nel) 
unsigned nel; 

void hdestroy ( ) 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Hsearch is a hash-table search routine generalized from Knuth (6.4) Algorithm D. It returns a 
pointer into a hash table indicating the location at which an entry can be found. Item is a struc¬ 
ture of type ENTRY (defined in the <search.h> header file) containing two pointers: item.key 
points to the comparison key, and item.data points to any other data to be associated with that 
key. (Pointers to types other than character should be cast to pointer-to-character.) Action is a 
member of an enumeration type ACTION indicating the disposition of the entry if it cannot be 
found in the table. ENTER indicates that the item should be inserted in the table at an 
appropriate point. FIND indicates that no entry should be made. Unsuccessful resolution is indi¬ 
cated by the return of a NULL pointer. 

Hcreate allocates sufficient space for the table, and must be called before hsearch is used. Nel is 
an estimate of the maximum number of entries that the table will contain. This number may be 
adjusted upward by the algorithm in order to obtain certain mathematically favorable cir¬ 
cumstances. 

Hdestroy destroys the search table, and may be followed by another call to hcreate. 

EXAMPLE 

The following example will read in strings followed by two numbers and store them in a hash 
table, discarding duplicates. It will then read in strings and find the matching entry in the hash 
table and print it out. 

#include <stdio.h> 

#include <search.h> 

struct info { /* this is the info stored in the table */ 

int age, room; /* other than the key. ♦/ 

}; 

#define NUM_EMPL 5000 /* # of elements in search table ♦/ 

main( ) 

{ 

/* space to store strings */ 
char string_space[NUM_EMPL*20]; 

/* space to store employee info */ 
struct info info_space[NUM__EMPL]; 

/* next avail space in string_space */ 
char Hcstr—ptr = string_space; 

/* next avail space in info__space */ 
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struct info *info_ptr = info_space; 

ENTRY item, *found_item, *hsearch( ); 

/* name to look for in table */ 
char name_to_Jind[30]; 
int i = 0; 

/* create table ♦/ 

(void) hcreate(NUIvUMPL); 

while (scanf("%s%d%d", str_ptr, &;info_ptr—>age, 

&;info_ptr—>room) != EOF kk. i++ < NUM_EMPL) { 

/* put info in structure, and structure in item */ 

item.key = str_ptr; 

item.data = (char *)info_ptr; 

str_ptr += strlen(str_ptr) + 1; 

info_ptr++; 

/* put item into table */ 

(void) hsearch(item, ENTER); 

} 

/* access table */ 

item.key = name_to_find; 

while (scanf("%s", item.key) != EOF) { 

if ((found_item = hsearch(item, FIND)) != NULL) { 

/♦if item is in the table ♦/ 

(void)printf("found %s, age = %d, room = %d\n", 
found_item—>key, 

((struct info *)found_item—>data)—>age, 

((struct info ♦)found_item—>data)—>room); 

} else { 

(void)printf("no such employee %s\n", 
name_to_find) 

} 

} 

} 

SEE ALSO 

bsearch(3C), lsearch(3C), malloc(3C), malloc(3X), string(3C), tsearch(3C). 

DIAGNOSTICS 

Hsearch returns a NULL pointer if either the action is FIND and the item could not be found or 
the action is ENTER and the table is full. 

Hcreate returns zero if it cannot allocate sufficient space for the table. 

WARNING 

Hsearch and hcreate use ma//oc (3C) to allocate space. 

BUGS 

Only one hash search table may be active at any given time. 
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NAME 

hypot - Euclidean distance function 
SYNOPSIS 

^include <math.h> 

double hypot (x, y) 
double X, y; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Hypot returns 

sqrt(x * X + y * y), 

taking precautions against unwarranted overflows. 

DIAGNOSTICS 

When the correct value would overflow, hypot returns HUGE and sets errno to ERANGE. 
These error-handling procedures may be changed with the function matherr{2M). 

SEE ALSO 

matherr(3M), sqrt(3F). 
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NAME 

initgroups - initialize group access list 
SYNOPSIS 

initgroups(name, basegid) 
char *name; 
int basegid; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: UCB 
DESCRIPTION 

Initgroups reads through the group file and sets up, using the setgroups{2) call, the group access 
list for the user specified in name. The basegid is automatically included in the groups list. Typi¬ 
cally this value is given as the group number from the password file. 

FILES 

/etc/logingroup 

SEE ALSO 

setgroups(2) 

DIAGNOSTICS 

Initgroups returns -1 if it was not invoked by the super-user. 

BUGS 

Initgroups uses the routines based on getgrent{Z). If the invoking program uses any of these rou¬ 
tines, the group structure will be overwritten in the call to initgroups. 

On most systems, no one seems to keep /etc/logingroup up to date. 
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NAME 

intrapoff, intrapon - disable/enable integer trap handler 

SYNOPSIS 

int intrapoff() 

int intrapon 0 

HP-UX COMPATIBILITY 

Level: HP-UX/NON-STANDARD 

Origin: HP 

Remarks: Intrapoff and intrapon are implemented on the Series 500 only. 

DESCRIPTION 

The Series 500 architecture has a single trap handler for both integer overflow (an integer value 
greater than 2"31-1) and integer divide-by-zero. By default, an operation which results in 
integer overflow or integer divide-by-zero invokes the integer trap handler. Any integer divide- 
by-zero generates the signal SIGFPE. As a side effect, any integer overflow also invokes the 
integer trap handler. The trap handler recognizes integer overflow as a special case and simply 
returns to the calling routine. A user sees no difference in results, but could see a severe perfor¬ 
mance degradation depending on how often the trap handler is invoked. 

Intrapoff disables this integer trap handler. Integer overflow and integer divide-by-zero do not 
invoke the integer trap handler. Instead, integer divide-by-zero returns a large integer (2"31-1). 
Integer overflow operations simply overflow into the most significant bit. There is no performance 
penalty since the trap handler is not entered. 

A program doing many integer overflows could see a significant performance improvement. A 
user must take care however, since integer divide-by-zero does not give signal SIGFPE while the 
integer trap handler is disabled. 


Intrapon restores the default condition. Integer divide-by-zero and integer overflow operations 
invoke the integer trap handler. Integer divide-by-zero gives signal SIGFPE; integer overflow 
results in a performance penalty caused by entering and leaving the integer trap handler. 

When intrapoff is used, the integer trap handler is disabled at that procedural level and all levels 
below it. It is not disabled for any procedural level above the procedure within which intrapoff 
was called. For example, 

a(); 

{ 

b(); /* Call function b. */ 

} 

b(); 

{ 

intrapoff(); 

c(); /* Call function c. */ 

} 

c(); 

{ 

/* Do some work. */ 

} 

The integer trap handler is disabled for functions b and c. It is automatically re-enabled on exit 
from function b. The integer trap handler can also be re-enabled at any time using intrapon. 


EXAMPLES 

The math library routine rand generates random integers using: 
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randx = randx * (((1103515245L + 12345)»16) & OxTfFff) 

where randx is an unsigned integer. The value assigned to randx is often greater than 2 "31-1. 
To avoid the performance degradation of entering the integer trap handler each time this occurs, 
the integer trap can be turned off before the assignment using intrapoff. 
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NAME 

io_burst - perform low overhead I/O with an HP-IB channel 

SYNOPSIS 

^include <dvio.h> 
io_burst (eid, flag) 

HP-UX COMPATIBILITY 

Level: Device I/O Library-HP-UX/EXTENDED NON-STANDARD 

Origin: HP 

Remarks: lo—hurst is implemented on the Series 200/300 only. 

DESCRIPTION 

lo—hurst enables you to perform low-overhead burst transfers on the specified HP-IB bus. Eid is 
the entity identifier for an open HP-IB bus device file returned by a previous call to open(2), 
dup(2), creat(2) or to fcntl(2) with an F_DUPD command option. Flag is an integer which, if 
non-zero, enables burst mode, and otherwise disables it. 

In burst mode, memory-mapped I/O address space assigned to the interface card select code is 
mapped directly into user address space such that the user can transfer data directly to or from 
the interface card. This eliminates the need for kernel calls and their associated overhead . Burst 
mode affects only read(2), write(2), hpih^io(3), and hpih—send—cmnd(S) calls. All other opera¬ 
tions are unaffected. When burst mode is enabled, the interface is locked and no other processes 
are allowed to use the interface until burst mode is disabled. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Timeouts for read(2), write(2), hpih—io(S), and hpihsencU.cmnd(3) do not work while 
in burst mode. However, these commands can be interrupted by signals. 

RETURN VALUE 

lo—.hurst returns zero if successful or -1 if an error was encountered. 

DIAGNOSTICS 

lo _ hurst fails under any of the following circumstances and sets errno (see errno{2)) to the value 

in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB bus device file [ENOTTY]; 

a timeout occurs [EIO]; 

WARNING 

Enabling burst mode locks the interface and should not be used with any interface supporting a 
system disc or swap device. 

SEE ALSO 

read(2), write(2), hpib_io(3I), hpib_send_^cmnd(3I) 
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NAME 

io—eol_ctl - set up read termination character on special file 

SYNOPSIS 

int io_eol_ctl (eid, flag, match); 

int eid, flag, match; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Io _ eoL—ctl enables you to specify a character to be used in terminating a read operation from 

the specified file id, 

Eid is an entity identifier of an open HP-IB raw bus device file obtained from an open (2), dup{2), 
fcntl(2), or creat{2) call. Flag is an integer which enables or disables character-match termina¬ 
tion. A non-zero value enables character-match termination, while a zero value disables it. Match 
is an integer containing the numerical equivalent of the termination character. Match is ignored if 
flag is zero. When in 8-bit mode, the lower 8 bits of match are used as the termination character. 
In 16-bit mode, the lower 16 bits are used. 

Upon opening a file, the default condition is character-match termination disabled. When 
enabled, the character specified by match is checked for during read operations. The read is ter¬ 
minated upon receipt of this character, or upon any of the other termination conditions normally 
in effect for this file. Examples of other conditions are satisfying the specified byte count, and 
receiving a character when the EOI line is asserted (HP-IB). When the read is terminated by a 
match character, this character is the last character returned in the buffer. 

File descriptors for the same device file obtained by separate open{2) requests have their own ter¬ 
mination characters associated with them. File descriptors for the same device file inherited by a 
fork{2) request share the same termination character. In the latter case, if one process changes 
the termination character, the new termination character is in effect for all such file descriptors. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (hides) that identifles an open device special hie. 

Series 500: 

When termination is requested in 16-bit mode, the upper byte of the halfword is exam¬ 
ined hrst, and then the lower byte. If the lower byte matches the termination character, 
all is as expected. However, if the upper byte matches, the following action is taken: 

both the upper and lower bytes are moved into the given buffer, and 

the count returned is odd, indicating that there is a lower byte following the 
matching upper byte. This information is passed to the upper level software to 
deal with as it pleases. 

RETURN VALUE 

lo-CoL-ctl returns 0 (zero) if successful, or -1 if an error was encountered. 

SEE ALSO 

io_width_ctl(3I). 

DIAGNOSTICS 

lo-CoL-ctl fails under the following circumstances, and sets errno (see errno(2)) to the value in 
square brackets: 

eid does not refer to an open file [EBADF]; 


Hewlett-Packard 


- 1 - 


November 15, 1985 



IO_EOL_CTL(3I) 


IO_EOL_CTL(3I) 


eid does not refer to a channel device file [KNOTTY]. 
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NAME 

io_get_term_reason - determine how last read terminated 

SYNOPSIS 

int io_get_teriii_reason (eid); 

int eid; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

Io-.get—term^reason returns the termination reason for the last read made on this file descrip¬ 
tor. Eid is an entity identifier of an open HP-IB raw bus device file obtained from an open(2), 
dwp(2), fcntl(2), or creat(2) call. 

All file descriptors descending from an open{2) request (such as from dup(2) or fork{2)) set this 
status. For example, if the calling process had opened this file descriptor, and later forked, the 
status returned would be from the last read done by either the calling process or its child. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (hides) that identihes an open device special hie. 

Series 500: 

If the last read had multiple applicable termination reasons, such as having EOI asserted 
on the last byte when that byte was the termination match character (see m_eoiL_ci/(3)), 
the highest numbered reason is used (in this case, 4). Since interactive terminals are 
treated as record-oriented devices when they are in cooked mode, the termination reason 
is 4 when terminated by a new-line character. If no read has been done on the hie 
descriptor since it was opened, the termination reason is 0. 

Series 200/300: 

PSTS is checked only at the beginning of a transfer. An interrupt caused by an EIR will 
also terminate a transfer. The termination reason in this case is also 4. 

SEE ALSO 

io_eol_ctl(3I). 

RETURN VALUE 

lo^get—term—reason returns a value indicating how the last read on the specihed hie descriptor 
was terminated. This value is interpreted as follows (note that combinations are possible): 

Value Description 

-1 An error was encountered while making this function request. 

0 Last read encountered some abnormal termination reason not covered by 

any of the other reasons. 

1 Last read terminated by reading the number of bytes requested. 

2 Last read terminated by detecting the specihed termination character. 

4 Last read terminated by detecting some device-imposed termination 

condition. Examples are: EOI for HP-IB, PSTS line on GPIO, or some other 
end-of-record condition, such as the physical end-of-record mark on a 9-track 
tape. 

DIAGNOSTICS 

lo—get—term—reason fails under the following circumstances, and sets errno (see errno{2)) to the 
value in square brackets: 

eid does not refer to an open hie [EBADF]; 
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eid does not refer to a channel device file [KNOTTY]. 
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NAME 

io_interrupt_ctl - enable/disable interrupts for the associated eid. 

SYNOPSIS 

int io_interrupt_ctl (eid, enable_flag) 
int eid, enable_flag; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

Remarks: lo—interrupt—ctl is implemented on the Series 500 only. 

DESCRIPTION 

Eid is an entity identifier of an open raw HP-IB bus or GPIO device file, obtained from an open{2), 
dup{2), fcntl{2), or creat{2) call. Enable—flag is an integer which enables or disables interrupts for 
the associated eid. A non-zero value enables interrupts. 

Interrupts may be disabled or enabled by the user as desired. When an interrupt occurs for a 
given eid, the interrupts associated with this eid are automatically disabled from reoccurring. 
Interrupts for this eid can be re-enabled by using io—interrupt—ctl 

RETURN VALUE 

io—interrupt—ctl returns 0 (zero) if successful, or -1 if an error was encountered. 

DIAGNOSTICS 

lo—interrupt—ctl fails under the following situations and sets errno (see errno{2)) to the value in 
square brackets: 

eid does not refer to an open file [EBADF] 

eid does not refer to a device that supports interrupts [ENOTTY] 
no interrupt conditions were specified for this eid [EINVAL] 

SEE ALSO 

io—on—interrupt(Sl) 
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NAME 

io—on_interrupt - device interrupt (fault) control 

SYNOPSIS 

#include <dvio.h> 

int (*io_on__interrupt (eid, causevec, handler))() 
int eid; 

struct interrupt_struct *causevec; 
int (*handler)(); 

handler (eid, causevec) 
int eid; 

struct interrupt—struct *causevec; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

Remarks: lo—on—interrupt is implemented on the Series 500 only. 

DESCRIPTION 

Eid is an entity identifier of an open raw HP-IB bus or GPIO device file, obtained from an open{2), 
dup(2), fcntl{2), or creat{2) call. 

Causevec is a pointer to a structure of the form: 

struct interrupt—struct { 

int cause; 
int mask; 

}; 

The interrupt—struct structure is defined in the file dvio.h. 

The cause parameter is a bit vector specifying which of the interrupt or fault events will cause the 
handler routine to be invoked. The interrupt causes are often specific to the type of interface 
being considered. As well, certain exception (error) conditions can be handled using the 
io—on—interrupt capability. Specifying a zero-valued cause vector effectively turns off the inter¬ 
rupts for that eid. 

The mask parameter is used when an HP-IB parallel poll interrupt is being defined. Mask is an 
integer that specifies which parallel poll response lines are of interest. Mask’s value is obtained 
from an 8-bit binary number, each bit of which corresponds to one of the eight lines. For example, 
if you want an interrupt handler invoked for a response on lines 2 or 6, the correct binary number 
is 01000100. This converts to a decimal equivalent of 68, which is the number you should assign to 
mask. 

When an interrupt that is to be caught occurs during a read, write, open, or ioctl system call on a 
slow device (like a terminal; but not a file), during a pause system call, during a sigpause{2) sys¬ 
tem call, or during a wait system call that does not return immediately due to the existence of a 
previously stopped or zombie process, the interrupt handling function will be executed and the 
interrupted system call will return a -1 to the calling process with errno set to EINTR. 

Interrupt handlers are not inherited across a fork(2). All eid for the same device file produced by 
dup{2) share the same handler. 

An interrupt for a given eid is implicitly disabled after the occurrence of the event. The interrupt 
condition can be re-enabled by using io—interrupt—ctl{3l). 

Upon the occurrence of an event specified by cause, the receiving process is to execute the inter¬ 
rupt handler function pointed to by handler. When the handler returns the user process resumes 
at the point of execution left when the event occurred. 
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Handler will be passed two parameters, the eid associated with the event, and a pointer to a 
cauaevec structure. The cause of the interrupt can be determined by the value returned in the 
cause field of the causevec structure. If the interrupt handler was invoked due to a parallel poll 
interrupt, then the mask field of the causevec structure will contain the parallel poll response 
byte XOR-ed with the sense and AND-ed with the mask 

HPIB INTERRUPTS 

This section describes interrupt causes specific to an HP-IB device. For an HP-IB device the cause 
is a bit vector which is used as follows: To enable a given event, the appropriate bit (in cause), 
shown below, must be set to 1: 


SRQ 

SRQ and active controller. 

TLK 

Talker addressed. 

LTN 

Listener addressed. 

TCT 

Controller in charge. 

IFC 

IFC has been asserted 

REN 

Remote enable 

DCL 

Device clear 

GET 

Group execution trigger 

PPOLL 

Parallel poll 


GPIO INTERRUPTS 

This section describes interrupt causes specific to a gpio device. For a gpio device the cause is a 
bit vector which is used as follows. To enable a given event, the appropriate bit (in cause), shown 
below, must be set to 1: 


EIR External interrupt 

SIEO Status line 0 

SIEl Status line 1 


HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

The 5.0 HP_UX system does not support parallel-poll interrupts. The internal HP-IB 

supplied with the Model 550 cannot support talker-addressed, listener-addressed, 
controller-in-charge, and remote-enable interrupt. GPIO interrupts on the EIR line are 
not supported. 

RETURN VALUE 

lo—on—interrupt returns a pointer to the previous handler if the new handler is successfully 
installed, otherwise it returns a -1 and errno is set. 

DIAGNOSTICS 

lo—on—interrupt can fail for any of the following reasons: 

Fildes does not refer to an open file [EBADF] 

Fildes does not refer to a GPIO or a raw HP-IB device file [ENOTTY] 

Handler points to an illegal address [EFAULT] 
causevec points to an illegal address. [EFAULT] 
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SEE ALSO 

io_interrupt_ctl(3I), pause(2), sigpause(2) 
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NAME 

io_reset - reset an I/O interface 

SYNOPSIS 

int io_reset (eid); 
int eid; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

lo—reset resets the interface associated with the device file that was opened. The specific actions 
performed by lo^reset are hardware dependent. Eid is an entity identifer of an open raw HP-IB 
bus or GPIO device file obtained from an open(2), dwp(2), fcntl(2), or creat{2) call. 

lo—.reset also causes an interface to go through its self-test, and returns a failure indication if 
the interface fails its test. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

When an HP-IB interface is reset, the interface is returned to its power on state if system 
controller, otherwise, the parallel poll response is set to zero and the interrupt mask is set 
to zero. 

When a GPIO interface is reset, the interfae is returned to its power on state. 

Series 200/300: 

When an HP-IB interface is reset, the interrupt mask is set to 0, the parallel poll response 
is set to 0, the serial poll response is set to 0, the HP-IB address is assigned, the IFC line is 
pulsed (if system controller), the card is put on line, and REN is set (if system controller). 

When a GPIO interface is reset, the peripheral reset line is pulled low, the PCTL line is 
placed in the clear state, and if the DOUT CLEAR jumper is installed, the data out lines 
are all cleared. The interrupt enable bit is also cleared. 

Interface selftest is not supported. 

RETURN VALUE 

lo—reset returns 0 (zero) if successful, or -1 if an error was encountered. 

DIAGNOSTICS 

lo—reset fails under any of the following circumstances, and sets errno (see errno(2)) to the value 
in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [KNOTTY]. 
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NAME 

io_speed_ctl - inform system of required transfer speed 

SYNOPSIS 

int io_speed_ctl (eid, speed); 
int eid, speed; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

lo—speed—ctl enables you to select the data transfer speed (within the limits of the hardware) for 
a data path used for a particular interface. The transfer method (i.e., DMA, fast-handshake) 
chosen by the system is determined by the speed requirements. 

Eid is an entity identifier of an open HP-IB raw bus device file obtained from an open{2), dup{2), 
fcntl{2), or creat{2) call. Speed is an integer specifying the data transfer speed in K-bytes per 
second (one K-byte equals 1024 bytes). 

DEPENDENCIES 

Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

The Series 500 always provides DMA for the fastest possible I/O speed. Therefore, 
iospeed—ctl(31) is a nonoperative condition. 

Series 200/300: 

For values of speed less than 7 the system will use an interrupt transfer. For larger 
values DMA will be used if available otherwise the system will use an interrupt transfer. 
The default transfer method is DMA. 

RETURN VALUE 

lo—speed—ctl returns 0 if successful, and -1 otherwise. 

DIAGNOSTICS 

lo _ speed—ctl fails under the following conditions, and sets errno to the value enclosed in square 

brackets: 

eid does not refer to an open file [EBADF]. 

eid does not refer to a supported device file [ENOTTY]. 
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NAME 

io_tinieout_ctl - establish a time limit for I/O operations 
SYNOPSIS 

int io_timeout_ctI (eid, time); 
int eid; 
long time; 

HP-UX COMPATIBILITY 

Level: Device I/O Library - HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

lo _ timeout _ ctl enables you to assign a timeout value to the specified file descriptor. Eid is an 

entity identifier of an open HP-IB raw bus device file obtained from an open(2), dup(2), fcntl{2), 
or creat{2) call. Time is a 32-bit integer value specifying the length of the timeout in 
microseconds. 

This timeout applies to future read and write requests on this file descriptor. If a read or write 
request does not complete within the specified time limit, the request is aborted and returns 
an error indication. The errno value for a timed-out request is EIO, specifying that a timeout has 
occurred. 

Although the timeout value is specified in microseconds, the resolution of the timeout is system- 
dependent. For example, a particular system might have a resolution of 10 milliseconds, in which 
case the specified timeout value is rounded up to the next 10 msec boundary. A timeout value of 
zero means that the system never causes a timeout. When a file is opened, a zero timeout value is 
assigned by default. 

File descriptors for the same device file obtained by separate open (2) requests have their own 
timeout values associated with them. File descriptors for the same device file obtained by dup{2) 
or inherited by a fork{2) request share the same timeout value. In the latter case, if one process 
changes the timeout, the new timeout is in effect for all such file descriptors. 

HARDWARE DEPENDENCIES 
Series 200/300/500 

Eid is an integer file descriptor (fildes) that identifies an open device special file. 

Series 500: 

The timeout resolution is 10 msec. If an I/O operation is aborted due to a timeout, an 
errinfo{2) value of 56 is returned. 

Series 200 and 300: 

The default timeout for Series 200/300 GPIO interface is 15 seconds. Timeout resolution 
is 20 msec. 

RETURN VALUE 

lo—timeout—ctl returns 0 (zero) if successful, or -1 if an error was encountered. 

DIAGNOSTICS 

lo—timeout—ctl fails under the following circumstances, and sets errno (see errno(2)) to the value 
in square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to a channel device file [KNOTTY]. 
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NAME 

io_width_ctl - set width of data path 

SYNOPSIS 

int io_width_ctl (eid, width) 
int eid, width; 

HP-UX COMPATIBILITY 

Level: Device I/O Library ~ HP-UX/EXTENDED 

Origin: HP 

DESCRIPTION 

lo—width—ctl enables you to select the width of the data path to be used for a particular inter¬ 
face. Eid is an entity identifier of an open device file obtained from an open{2), dup{2), fcntl{2), 
or creat{2) call. Width is an integer specifying the width of the data path in bits. 

The allowable widths are system and hardware dependent. An error is given if an invalid width 
is specified. Specifying a width with this function sets the width for all users of the device file 
associated with the given file descriptor. When first opened, the default width is 8 bits. 

HARDWARE DEPENDENCIES 
Series 200/300/500: 

For the GPIO interface only widths of 8 and 16 bits are currently supported. For the 
HP-IB interface only width of 8 bits is supported. 

RETURN VALUE 

lo _ width _ ctl returns 0 if successful, and -1 if an error was encountered. 

DIAGNOSTICS 

lo—width—ctl fails under the following circumstances, and sets errno (see errno{2)) to the value in 
square brackets: 

eid does not refer to an open file [EBADF]; 

eid does not refer to an HP-IB raw bus device file [ENOTTY]. 

the specified width is not supported on this device file [EINVAL]. 
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NAME 

13tol, ltol3 - convert between 3-byte integers and long integers 
SYNOPSIS 

void 13tol (Ip, cp, n) 
long *lp; 
char *cp; 
int n; 

void ltol3 (cp, Ip, n) 
char *cp; 
long *lp; 
int n; 

HP-UX COMPATIBILITY 

Level: Bell File System - HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

LStol converts a list of n three-byte integers packed into a character string pointed to by cp into 
a list of long integers pointed to by Ip. 

LtolS performs the reverse conversion from long integers (Ip) to three-byte integers {cp). 

These functions are useful for file-system maintenance where the block numbers are three bytes 
long. 

SEE ALSO 
fs(5). 

BUGS 

Because of possible differences in byte ordering, the numerical values of the long integers are 
machine-dependent. 
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NAME 

langinfo, langtoid, idtolang, currlangid - information on user’s native language as given by NLS 
SYNOPSIS 

#include <langinfo.h> 

char ’“langinfo(langid, item) 
int langid, item; 

int langtoid(langname) 
char *langname; 

char *idtolang(langid) 
int langid; 

int currlangid() 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Native Language Support: 

8-bit data, customs, messages 

DESCRIPTION 

Langinfo retrieves a null-terminated string containing information unique to a language or cul¬ 
tural area. For example langinfo(currlangidf), DAY—1) returns a pointer to the string “Dom” if 
LANG (see environ{7)) is set to “Portuguese”, and “sun” if LANG is set to “finnish”. The fol¬ 
lowing items have been defined. 

D_T_FMT string for formatting date(l) 

DAY_1 Name of the first day of the week (“Sunday” in English) 

DAY_7 Name of the seventh day of the week 

ABDAY_1 Abbreviated name of the first day of the week (“Sun” in English) 

ABDAY_7 Abbreviated name of the seventh day of the week 

MON_l Name of the first month in the Gregorian year 

MON_12 Name of the twelfth month 

ABMON_l Abbreviated name of the first month 

ABMON_12 Abbreviated name of the twelfth month 
RADIXCHAR radix character (“decimal point” in English) 

THOUSEP separator for thousands 

YESSTR affirmative response for yes/no questions 

NOSTR negative response for yes/no questions 

CRNCYSTR symbol for currency preceded by if it precedes the number. For example, "-f" 
would be used for Dutch, Kr" for Danish. 

Currlangid looks for a LANG string in the user’s environment. If it finds it, it returns the 
corresponding integer listed in langid{7). Otherwise it returns 0 to indicate a default to native- 
computer, the method used before Native Language Support (NLS) was available. 
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Idtolang takes the integer langid and attempts to return the corresponding character string 
defined in langid{7). If langid is not foimd, an empty string is returned. 

Langtoid is the reverse of idtolang, trying to convert a string to a language ID, and returning 0 to 
indicate native-computer if a match cannot be found. 

SEE ALSO 

getenv(3C), environ(7), hpnls(7), langid(7). 

BUGS 

Langinfo returns a pointer to a static area which is overwritten on each call. 


He wlett-P ackard 


-2- 


July 2, 1985 



L0GNAME(3X) 


LOGNAME(3X) 


NAME 

logname - return login name of user 

SYNOPSIS 

char *logname( ) 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Logname returns a pointer to the null-terminated login name; it extracts the $LOGNAME vari¬ 
able from the user’s environment. 

This routine is kept in /lib/libPW.a. 

FILES 

/etc/profile 
SEE ALSO 

env(l), login(l), profile(5), environ(7). 

BUGS 

The return values point to static data whose content is overwritten by each call. 

This method of determining a login name is subject to forgery. 
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NAME 

Isearch, Ifind - linear search and update 
SYNOPSIS 

char *lsearch ((char *)key, (char *)base, nelp, sizeof(*key), compar) 
unsigned *nelp; 
int (*compar)( ); 

char *lfind ((char *)key, (char *)base, nelp, sizeof(*key), compar) 
unsigned *nelp; 
int (♦compar) ( ); 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Lsearch is a linear search routine generalized from Knuth (6.1) Algorithm S. It returns a pointer 
into a table indicating where a datum may be found. If the datum does not occur, it is added at 
the end of the table. Key points to the datum to be sought in the table. Base points to the first 
element in the table. Nelp points to an integer containing the current number of elements in the 
table. The integer is incremented if the datum is added to the table. Compar is the name of the 
comparison function which the user must supply {strcmp, for example). It is called with two 
arguments that point to the elements being compared. The function must return zero if the ele¬ 
ments are equal and non-zero otherwise. 

Lfind is the same as Isearch except that if the datum is not found, it is not added to the table. 
Instead, a NULL pointer is returned. 

NOTES 

The pointers to the key and the element at the base of the table should be of type pointer-to- 
element, and cast to type pointer-to-character. 

The comparison function need not compare every byte, so arbitrary data may be contained in the 
elements in addition to the values being compared. 

Although declared as type pointer-to-character, the value returned should be cast into type 
pointer-to-element. 

EXAMPLE 

This fragment will read in < TABSIZE strings of length < ELSIZE and store them in a table, elim¬ 
inating duplicates. 

#include <stdio.h> 

#define TABSIZE 50 
#define ELSIZE 120 

char line[ELSIZE], tab [TABSIZE] [ELSIZE], *lsearch( ); 
unsigned nel = 0; 
int strcmp( ); 

while (fgets(line, ELSIZE, stdin) != NULL ScSz 
nel < TABSIZE) 

(void) lsearch(line, (char *)tab, &;nel, 

ELSIZE, strcmp); 


SEE ALSO 

bsearch(3C), hsearch(3C), tsearch(3C). 
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DIAGNOSTICS 

If the searched for datum is found, both Isearch and Ifind return a pointer to it. Otherwise, Ifind 
returns NULL and Isearch returns a pointer to the newly added element. 

BUGS 

Undefined results can occur if there is not enough room in the table to add a new item. 
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NAME 

malloc, free, realloc, calloc - main memory allocator 
SYNOPSIS 

char ♦malloc (size) 
unsigned size; 

void free (ptr) 
char ♦ptr; 

char ♦realloc (ptr, size) 
char ♦ptr; 
unsigned size; 

char ♦calloc (nelem, elsize) 
unsigned nelem, elsize; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Malloc and free provide a simple general-purpose memory allocation package. Malloc returns a 
pointer to a block of at least size bytes suitably aligned for any use. 

The argument to free is a pointer to a block previously allocated by malloc; after free is per¬ 
formed this space is made available for further allocation, but its contents are left undisturbed. 

Undefined results will occur if the space assigned by malloc is overrun or if some random number 
is handed to free, 

Malloc allocates the first big enough contiguous reach of free space found in a circular search from 
the last block allocated or freed, coalescing adjacent free blocks as it searches. It calls sbrk (see 
brk{2)) to get more memory from the system when there is no suitable space already free. 

Realloc changes the size of the block pointed to by ptr to size bytes and returns a pointer to the 
(possibly moved) block. The contents will be unchanged up to the lesser of the new and old sizes. 
If no free block of size bytes is available in the storage arena, then realloc will ask malloc to 
enlarge the arena by size bytes and will then move the data to the new space. 

Realloc also works if ptr points to a block freed since the last call of malloc,, realloc^ or calloc; 
thus sequences of free, malloc and realloc can exploit the search strategy of malloc to do storage 
compaction. 

Calloc allocates space for an array of nelem elements of size elsize. The space is initialized to 
zeros. 

Each of the allocation routines returns a pointer to space suitably aligned (after possible pointer 
coercion) for storage of any type of object. 

SEE ALSO 

brk(2), malloc(3X). 

DIAGNOSTICS 

Malloc, realloc and calloc return a NULL pointer if there is no available memory or if the arena 
has been detectably corrupted by storing outside the bounds of a block. When this happens the 
block pointed to by ptr may be destroyed. 

BUGS 

Free does not check its pointer argument for validity. When passed a null pointer (value 0), it 
causes a memory fault. 

NOTE 

Search time increases when many objects have been allocated; that is, if a program allocates but 
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never frees, then each successive allocation takes longer. For an alternate, more flexible imple¬ 
mentation, see ma//oc(3X). 
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NAME 

malloc, free, realloc, calloc, mallopt, mallinfo - fast main memory allocator 
SYNOPSIS 

^include <malloc.h> 

char ^malloc (size) 
unsigned size; 

void free (ptr) 
char ♦ptr; 

char ♦realloc (ptr, size) 
char ♦ptr; 
unsigned size; 

char ♦calloc (nelem, elsize) 
unsigned nelem, elsize; 

int mallopt (cmd, value) 
int cmd, value; 

struct mallinfo mallinfo (max) 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 


DESCRIPTION 

Malloc and free provide a simple general-purpose memory allocation package, which runs consid¬ 
erably faster than the malloc{3C) package. It is found in the library “malloc”, and is loaded if 
the option “-Imalloc” is used with cc(l) or ld{l). 

Malloc returns a pointer to a block of at least size bytes suitably aligned for any use. 

The argument to free is a pointer to a block previously allocated by malloc\ after free is per¬ 
formed this space is made available for further allocation, and its contents will usually have been 
destroyed (but see mallopt below for a way to change this behavior). 

Undefined results will occur if the space assigned by malloc is overrun or if some random number 
is handed to free. 

Realloc changes the size of the block pointed to by ptr to size bytes and returns a pointer to the 
(possibly moved) block. The contents will be unchanged up to the lesser of the new and old sizes. 

Calloc allocates space for an array of nelem elements of size elsize. The space is initialized to 
zeros. 


Mallopt provides for control over the allocation algorithm. The available values for cmd are: 


M_MXFAST Set maxfast to value. The algorithm allocates all blocks below the size of maxfast 
in large groups and then doles them out very quickly. The default value for max- 
fast is 24. 

M_NLBLKS Set numlblks to value. The above mentioned “large groups” each contain numlblks 
blocks. Numlblks must be greater than 1. The default value for numlblks is 100. 


M_GRAIN Set grain to value. The sizes of all blocks smaller than maxfast are considered to 
be rounded up to the nearest multiple of grain. Grain must be greater than 0. 
The default value of grain is the smallest number of bytes which will allow align¬ 
ment of any data type. Value will be rounded up to a multiple of the default when 
grain is set. 


M_KEEP Preserve data in a freed block until the next malloc, realloc, or calloc. This option 
is provided only for compatibility with the old version of malloc and is not 
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recommended. 

These values are defined in the <maUoc.h> header file. 


Mallopt may be called repeatedly, but may not be called after the first small block is allocated. 

Mallinfo provides instrumentation describing space usage, but may not be called until the first 
small block is allocated. The max argument to mallinfo should always be specified as 0 for com¬ 
patibility with other systems. It returns the structure: 


struct mallinfo { 
int arena; 
int ordblks; 
int smblks; 
int hblkhd; 
int hblks; 
int usmblks; 
int fsmblks; 
int uordblks; 
int fordblks; 
int keepcost; 


} 


/* total space in arena */ 

/* number of ordinary blocks */ 

/* number of small blocks */ 

/* space in holding block headers */ 
/* number of holding blocks */ 

/* space in small blocks in use */ 

/* space in free small blocks */ 

/* space in ordinary blocks in use */ 
/* space in free ordinary blocks */ 

/* space penalty if keep option */ 

/* is used */ 


This structure is defined in the <malloc.h> header file. 


Each of the allocation routines returns a pointer to space suitably aligned (after possible pointer 
coercion) for storage of any type of object. 

SEE ALSO 

brk(2), malloc(3C). 

DIAGNOSTICS 

Malloc, realloc and calloc return a NULL pointer if there is not enough available memory. When 
realloc returns NULL, the block pointed to by ptr is left intact. If mallopt is called after any allo¬ 
cation of a small block or if cmd or value are invalid, non-zero is returned. Otherwise, it returns 
zero. 


WARNINGS 

This package usually uses more data space than malloc (SC). 

The code size is also bigger than malloc (SC). 

Note that unlike ma//oc(3C), this package does not preserve the contents of a block when it is 
freed, unless the M_JKEEP option of mallopt is used. 

Undocumented features of malloc(SC) have not been duplicated. 
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NAME 

matherr - error-handling function 

SYNOPSIS 

^include <math.h> 

int matherr (x) 
struct exception *x; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Matherr is invoked by functions in the Math Library when errors are detected. Users may define 
their own procedures for handling errors, by including a function named matherr in their pro¬ 
grams. Matherr must be of the form described above. When an error occurs, a pointer to the 
exception structure x will be passed to the user-supplied matherr function. This structure, which 
is defined in the <math.h> header file, is as follows: 

struct exception { 
int type; 
char *name; 

double argl, arg2, retval; 

}; 

The element type is an integer describing the type of error that has occurred, from the following 
list of constants (defined in the header file): 

DOMAIN argument domain error 
SING argument singularity 

OVERFLOW overflow range error 
UNDERFLOW underflow range error 
TLOSS total loss of significance 

PLOSS partial loss of significance 

The element name points to a string containing the name of the function that incurred the error. 
The variables argl and arg2 are the arguments with which the function was invoked. Retval is 
set to the default value that will be returned by the function unless the user’s matherr sets it to a 
different value. 

If the user’s matherr function returns non-zero, no error message will be printed, and errno will 
not be set. 

If matherr is not supplied by the user, the default error-handling procedures, described with the 
math functions involved, will be invoked upon error. These procedures are also summarized in the 
table below. In every case, errno is set to EDOM or ERANGE and the program continues. 

EXAMPLE 

^include <math.h> 

int 

matherr (x) 

register struct exception *x; 

{ 

switch (x->type) { 
case DOMAIN: 

/* change sqrt to return sqrt(-argl), not 0 */ 
if (!strcmp(x->name, "sqrt")) { 

x->retval = sqrt(-x->argl); 
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return (0); /* print message and set errno */ 

} 

case SING: 

/* all other domain or sing errors, print message and abort */ 
fprintf(stderr, "domain error in %s\n", x->name); 
abort ( ); 
case FLOSS: 

/♦ print detailed error message ♦/ 
fprintf(stderr, "loss of significance in %s(%g) = %g\n", 
x->name, x->argl, x->retval); 
return (1); /* take no other action */ 

} 

return (0); /♦ all other errors, execute default procedure */ 

} 


DEFAULT ERROR HANDLING PROCEDURES 



Types of Errors 

type 

DOMAIN 

SING 

OVERFLOW 

UNDERFLOW 

TLOSS 

FLOSS 

errno 

EDOM 

EDOM 

ERANGE 

ERANGE 

ERANGE 

ERANGE 

BESSEL: 

- 

- 


- 

M,0 

* 

yO, yl, yn farg < 0) 

M, -H 


- 


- 

- 

EXP: 

_ 

. 

H 

0 

_ 

_ 

LOG, LOGIO: 







(arg < 0) 

M, -H 

- 

- 

- 

- 

- 

(arg = 0) 

- 

M, -H 

- 

- 

- 

- 

POW: 

- 

- 

±H 

0 

- 

- 

neg ** non-int 

M, 0 

- 


- 

- 

- 

0 ** non-pos 







SQRT: 

M, 0 

_ 


. 

_ 

_ 

GAMMA: 

_ 

M, H 

H 

. 

_ 

_ 

HYPOT: 

_ 

_ 

H 

. 

_ 

_ 

SINK: 

_ 

_ 

±H 

_ 

_ 

_ 

COSH: 


_ 

H 

_ 

_ 

_ 

SIN, COS, TAN: 

- 

. 

. 

_ 

M,0 

* 

ASIN, ACOS, ATAN2: 

M, 0 

- 

- 

- 

- 

- 


ABBREVIATIONS 

* As much as possible of the value is returned. 
M Message is printed (EDOM error). 

H HUGE is returned. 

-H -HUGE is returned. 

±H HUGE or -HUGE is returned. 

0 0 is returned._ 
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NAME 

memccpy, memchr, memcmp, memcpy, memset - memory operations 
SYNOPSIS 

^include <memory.h> 

char *memccpy (si, s2, c, n) 
char *sl, *82; 
int c, n; 

char ♦memchr (s, c, n) 
char *s; 
int c, n; 

int memcmp (si, s2, n) 
char *sl, *82; 
int n; 

char ♦memcpy (si, s2, n) 
char ♦si, ^82; 
int n; 

char ♦memset (s, c, n) 
char ♦&; 
int c, n; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

These functions operate efficiently on memory areas (arrays of characters bounded by a count, not 
terminated by a null character). They do not check for the overflow of any receiving memory 
area. 

Memccpy copies characters from memory area s2 into si, stopping after the first occurrence of 
character c has been copied, or after n characters have been copied, whichever comes first. It 
returns a pointer to the character after the copy of c in si, or a NULL pointer if c was not found 
in the first n characters of s2. 

Memchr returns a pointer to the first occurrence of character c in the first n characters of 
memory area s, or a NULL pointer if c does not occur. 

Memcmp compares its arguments, looking at the first n characters only, and returns an integer 
less than, equal to, or greater than 0, according as si is lexicographically less than, equal to, or 
greater than s2. (n less than or equal to zero yields equality). This routine uses unsigned char 
for character comparison on HP-UX. This may not be true for other implementatitons. 

Memcpy copies n characters from memory area s2 to si. It returns si. 

Memset sets the first n characters in memory area s to the value of character c. It returns s. 

NOTE 

For user convenience, all these functions are declared in the optional <memory.h> header file. 

BUGS 

Character movement is performed differently in different implementations. Thus overlapping 
moves may yield surprises. 
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NAME 

mktemp - make a unique file name 
SYNOPSIS 

char *mktemp (template) 
char ^template; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Mktemp replaces the contents of the string pointed to by template by a unique file name, and 
returns the address of template. The string in template should look like a file name with six trail¬ 
ing Xs; mktemp will replace the Xs with a letter and the current process ID. The letter will be 
chosen so that the resulting name does not duplicate the name of an existing file. If there are less 
than 6 Xs, the letter will be dropped first, and then high order digits of the process ID will be 
dropped. 

RETURN VALUE 

Mktemp returns its argument except when it runs out of letters, in which case the result is a 
pointer to the empty string 

SEE ALSO 

getpid(2). 

SEE ALSO 

getpid(2), tmpfile(3S), tmpnam(3S). 

BUGS 

It is possible to run out of letters. 

Mktemp does not check to see if the file name part of template exceeds the maximum length of a 
file name. 


Hewlett-Packard 


- 1 - 


July 2, 1985 



MONITOR (3C) 


Series 200 Only 


MONITOR (30) 


NAME 

monitor - prepare execution profile 
SYNOPSIS 

^include <mon.h> 

void monitor (lowpc, highpc, buffer, bufsize, nfunc) 
int (*lowpc)(), (♦highpc)(); 

WORD ♦buffer; 
int bufsize, nfunc; 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 
Remarks: 

Monitor is implemented on Series 200 only. 

DESCRIPTION 

An executable program created by cc -p automatically includes calls for monitor with default 
parameters; monitor need not be called explicitly except to gain fine control over profiling. 

Monitor is an interface to profil{2). Lowpc and highpc are the addresses of two functions; buffer is 
the address of a (user supplied) array of bufsize WORDs (defined in the <mon.h> header file). 
Monitor arranges to record a histogram of periodically sampled program counter values and 
counts of calls to certain functions in the buffer. The lowest address sampled is that of lowpc and 
the highest is just below highpc. Lowpc must not equal 0 for this use of monitor. Not more than 
nfunc call counts can be kept; only calls to functions that were compiled with the -p profiling 
option of cc(l) are recorded. For results to be significant, especially where there are small, 
heavily-used routines, it is suggested that the buffer be no more than a few times smaller than the 
range of locations sampled. 

To profile the entire program, it is sufficient to use 
extern etext(); 

monitor(2, etext, buf, bufsize, nfunc); 

Etext lies just above all the program text (see end{ZC)). 

To stop execution monitoring and write the results on the file mon.out, use 
monitor (0); 

Prof{\) can then be used to examine the results. 

FILES 

mon.out 
SEE ALSO 

cc(l), prof(l), profil(2). 
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NAME 

nl_toupper, nl_tolower - translate characters for use with NLS 
SYNOPSIS 

int nl_toupper (c, langid) 
int c, langid; 

int nl_tolower (c, langid) 
int c, langid; 

HP-UX COMPATIBILITY 

Level; HP-UX/RUN ONLY 

Origin; HP 

Native Language Support; 

8-bit data, customs, messages 

DESCRIPTION 

These routines are extensions of their counterparts in conv(SC). They function in the same way, 
but have a second parameter whose value is expected to be one of the values defined in langid(7). 
If langid is not one of these legal values, or if shift information for langid has not been installed, 
they function as toupper() and tolower(). 

SEE ALSO 

conv(3C), ascii(7), hpnls(7), kana8(7), langid(7), roman8(7). 


Hewlett-Packard 


- 1 - 


July 2, 1985 



NL_CTYPE(3C) 


NL_CTYPE(3C) 


NAME 

nl_isalpha, nl_isupper, nl_islower, nl_isalimin, nl_ispuiict, nl_isprint, nl_isgraph - classify 
characters for use with NLS 

SYNOPSIS 

#include <nl_ctype.h> 

int nl_isalpha (c, langid) 
int c; int langid; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: HP 

Native Language Support: 

8-bit data, customs, messages 

DESCRIPTION 

These routines classify character-coded integer values by table lookup. Langid is as defined in 
langid(7). Each is a predicate returning non-zero for true, zero for false. All are defined for the 
range -1 to 255. If langid is not defined, or if type information for that language is not installed, 
isalpha, isupper, etc. will be used, returning 0 for values above octal 0200. 

nL-isalpha c is a letter. 

nl—isupper c is an upper-case letter. 
nl—islower c is a lower-case letter. 
nl—isalnum c is an alphanumeric (letter or digit). 

nl—ispunct c is a punctuation character (neither control nor alphanumeric). 

nl—isprint c is a printing character. 

nl—isgraph c is a printing character, like nl—isprint except false for space. 

DIAGNOSTICS 

If the argument to any of these is not in the domain of the function, the result is undefined. 

SEE ALSO 

ctype(3C), stdio(3S), ascii(7), hpnls(7) kana8(7), roman8(7). 
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NAME 

strcmpS, strncmpS, strcpmlG, strncmplG - non ASCII string collation used by NLS 
SYNOPSIS 

int strcmpS (si, s2, langid, status) 
unsigned char *sl, *s2; 
int langid,^status; 

int strncmpS (si, s2, n, langid, status) 
unsigned char *sl, *s2; 
int n, langid, ^status; 

int strcmpie (si, s2, file_name, status) 
unsigned char *sl, *s2, *file__name; 
int ^status; 

int StrncmplG (si, s2, n, file_name, status) 
unsigned char ♦si, *s2, *file_name; 
int n, ♦status; 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Native Language Support: 

8-bit and IG-bit data, customs, messages 

DESCRIPTION 

These functions do not check for overflow of any receiving string. 

StrcmpS compares string si and s2 according to the collating sequence specified by langid (See 
langid(7)). An integer greater than, equal to, or less than 0 is returned, according as si is greater 
than, equal to, or less than s2. If langid or the collation sequence file is not installed, the native 
machine collating sequence is used. Trailing blanks in string si or s2 are ignored. StrncmpS makes 
the same comparison but looks at most n characters. 

StrcmplO compares strings si and s2 according to the IG-bit collating sequence table in 
file—name (See col_seq_lG). Strings si and s2 may contain 16-bit character substrings in 8-bit 
canonical form. An integer greater than, equal to, or less than 0, according as si is greater than, 
equal to, or less than s2. StrncmplG makes the same comparison but looks at most n characters. 

The integer pointed to by status is set to one of the following non-zero values defined in 
/usr/include/langinfo.h if an abnormal condition is encountered. 

ENOCFFILE - the file /usr/lib/nls/con fig is missing 

ENOCONV - the entry for the language sought is not in the file /usr/lib/nls/config 

ENODIR - the directory /usr/lib/nls/% LANG cannot be accessed 

ENOLFILE - the data file /usr/lib/nls/%LANG/collates or file—name is missing 

EBADREAD - the data file /usr/lib/nls/%LANG/collates or file—name exists but seems to be 
corrupted 

SEE ALSO 

col_seq_16(5), col_seq_8(5), hpnls(7), langid(7). 
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NAME 

nlist - get entries from name list 
SYNOPSIS 

^include <nlist.h> 

int nlist (file-name, nl) 
char * file-name; 
struct nlist *nl; 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Remarks: 

Nlist is currently implemented on the Series 200 and the Integral PC only. 

The use of symbol table type and value information is inherently non-portable. Use of 
nlist should reduce the effort required to port a program which uses such information, 
but complete portability across all implementations of HP-UX cannot be expected. 

DESCRIPTION 

Nlist examines the name list in the executable file whose name is pointed to by file-name, and 
selectively extracts a list of values and puts them in the array of nlist structures pointed to by nl. 
The name list nl consists of an array of structures initially containing names of variables; once 
nlist has been called, the information is augmented with types and values. The list is terminated 
with a null name; that is, a null string is in the name position of the structure. Each variable 
name is looked up in the name list of the file. If the name is found, the type and value informa¬ 
tion is inserted into the structure. If the name is not found, the type and value fields are set to 
zero. The structure nlist is defined in the include file nlist.h. See a.out{^) and nlist{fi) for more 
discussion of the symbol table structure. 

The file must have the organization and symbol table described for an a.out file in a.out.h{b). 
The information is extracted from the symbol table used by the link editor, ld{l). 

The list of names provided by the caller is in an array of structures, each containing a pointer to a 
string giving the name for which information is desired. The rest of the structure contains a type 
field, a value field, and possibly other machine specific information which will be filled in by the 
nlist call. The list is terminated with a null name pointer. The structure updated by this call is 
described in nlist {h). The name pointer in the nlist structure will always be the first field regard¬ 
less of how the other fields may change across implementations. 

On machines which have such a file, this subroutine is useful for examining the system name list 
kept in the file /hp-ux. In this way programs can obtain system addresses that are up to date. 

NOTES 

The <nlist.h> header file is automatically included by <a.out.h> for compatability. However, if 
the only information needed from <a.out.h> is for use of nlist, then including <a.out.h> is 
discouraged. 

SEE ALSO 

a.out(5), nlist(5). 

DIAGNOSTICS 

All nlist structure fields are set to 0 if the file cannot be found or if it is not a valid object file 
containing a linker symbol table. 

Nlist returns -1 upon error; otherwise it returns 0. 
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NAME 

perror, errno, sys_errlist, sys—nerr - system error messages 

SYNOPSIS 

void perror (s) 
char *s; 

extern int errno; 

extern char *sys_errlist[ ]; 

extern int sys_nerr; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

Native Language Support: 

8-bit data, customs, messages 

DESCRIPTION 

Perror produces a message on the standard error output, describing the last error encountered 
during a call to a system or library function. The argument string s is printed first, then a colon 
and a blank, then the message and a new-line. To be of most use, the argument string should 
include the name of the program that incurred the error. The error number is taken from the 
external variable errno, which is set when errors occur but not cleared when non-erroneous calls 
are made. 

To simplify variant formatting of messages, the array of message strings sys—errlist is provided; 
errno can be used as an index in this table to get the message string without the new-line. 
Sys—nerr is the largest message number provided for in the table; it should be checked because 
new error codes may be added to the system before they are added to the table. 

If the user’s LANG shell variable is set, perror also attempts to return a translation of the error 
message. 

HARDWARE DEPENDENCIES 

Series 500: 

The error indicator errinfo is implemented in addition to errno, enabling you to obtain a 
more detailed description of the error. See errinfo{2). 

Translated messages not accessed. 

Series 200: 

Translated messages not accessed. 

SEE ALSO 

errinfo(2), errno(2). 
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NAME 

popen, pclose - initiate pipe I/O to/from a process 
SYNOPSIS 

#include <stdio.h> 

FILE *popen (command, type) 
char ^command, *type; 

int pclose (stream) 

FILE ^stream; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

The arguments to popen are pointers to null-terminated strings containing, respectively, a shell 
command line and an I/O mode, either r for reading or w for writing. Popen creates a pipe 
between the calling program and the command to be executed. The value returned is a stream 
pointer such that one can write to the standard input of the command, if the I/O mode is w, by 
writing to the file stream; and one can read from the standard output of the command, if the I/O 
mode is r, by reading from the file stream. 

A stream opened by popen should be closed by pclose^ which waits for the associated process to 
terminate and returns the exit status of the command. 

Because open files are shared, a type r command may be used as an input filter and a type w as 
an output filter. 

SEE ALSO 

pipe(2), wait(2), fclose(3S), fopen(3S), system(3S). 

DIAGNOSTICS 

Popen returns a NULL pointer if files or processes cannot be created, or if the shell cannot be 
accessed. 

Pclose returns -1 if stream is not associated with a “popen ed” command. 

BUGS 

If the original and “popened” processes concurrently read or write a common file, neither should 
use buffered I/O, because the buffering gets all mixed up. Problems with an output filter may be 
forestalled by careful buffer flushing, e.g. with fflush; see fclose{3S). 
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NAME 

printf, fprintf, sprintf - print formatted output 
SYNOPSIS 

^include <stdio.h> 

int printf (format [ , arg ] ... ) 
char ^format; 

int fprintf (stream, format [ , arg ] ... ) 

FILE ^stream; 
char *format; 

int sprintf (s, format [ , arg ) ... ) 

char *s, format; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Printf places output on the standard output stream stdout. Fprintf places output on the named 
output stream. Sprintf places "output", followed by the null character (\0), in consecutive bytes 
starting at *s; it is the user’s responsibility to ensure that enough storage is available. Each func¬ 
tion returns the number of characters transmitted (not including the \0 in the case of sprintf), or 
a negative value if an output error was encountered. 

Each of these functions converts, formats, and prints its args under control of the format. The 
format is a character string that contains two types of objects: plain characters, which are simply 
copied to the output stream, and conversion specifications, each of which results in fetching of 
zero or more args. The results are imdefined if there are insufficient args for the format. If the 
format is exhausted while args remain, the excess args are simply ignored. 

Each conversion specification is introduced by the character %. After the %, the following 
appear in sequence: 

Zero or more flags, which modify the meaning of the conversion specification. 

An optional decimal digit string specifying a minimum field width. If the converted value 
has fewer characters than the field width, it will be padded on the left (or right, if the 
left-adjustment fiag described below, has been given) to the field width. If the field 
width for an s conversion is preceded by a 0, the string is right adjusted with zero¬ 
padding on the left. 

A precision that gives the minimum number of digits to appear for the d, o, u, x, or X 
conversions, the number of digits to appear after the decimal point for the e and f 
conversions, the maximum number of significant digits for the g conversion, or the max¬ 
imum number of characters to be printed from a string in s conversion. The precision 
takes the form of a period (.) followed by a decimal digit string; a null digit string is 
treated as zero. 

An optional 1 (ell) specifying that a following d, o, u, x, or X conversion character applies 
to a long integer arg, or an optional h specifying that a following d, o, u, x, or X conver¬ 
sion character applies to a short integer arg. A 1 before any other conversion character is 
ignored. 

A character that indicates the type of conversion to be applied. 

A field width or precision may be indicated by an asterisk (*) instead of a digit string. In this 
case, an integer arg supplies the field width or precision. The arg that is actually converted is not 
fetched until the conversion letter is seen, so the args specifying field width or precision must 
appear before the arg (if any) to be converted. 
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The flag characters and their meanings are: 

The result of the conversion will be left-justifled within the held. 

-|- The result of a signed conversion will always begin with a sign (+ or -). 

blank If the flrst character of a signed conversion is not a sign, a blank will be prefixed to the 

result. This implies that if the blank and + flags both appear, the blank flag will be 
ignored. 

# This flag specifies that the value is to be converted to an "alternate form." For c, d, 

s, and u conversions, the flag has no effect. For o conversion, it increases the precision 
to force the first digit of the result to be a zero. For x or X conversion, a non-zero 
result will have Ox or OX prefixed to it. For e, E, f, g, and G conversions, the result 
will always contain a decimal point, even if no digits follow the point (normally, a 
decimal point appears in the result of these conversions only if a digit follows it). For 
g and G conversions, trailing zeroes will not be removed from the result (which they 
normally are). 

The conversion characters and their meanings are: 

d, o,u,x,X The integer arg is converted to signed decimal, unsigned octal, decimal, or hexade¬ 

cimal notation (x and X), respectively; the letters abcdef are used for x conversion 
and the letters ABCDEF for X conversion. The precision specifies the minimum 
number of digits to appear; if the value being converted can be represented in fewer 
digits, it will be expanded with leading zeroes. (For compatibility with older versions, 
padding with leading zeroes may alternatively be specified by prepending a zero to the 
field width. This does not imply an octal value for the field width.) The default pre¬ 
cision is 1. The result of converting a zero value with a precision of zero is a null 
string. 

f The float or double arg is converted to decimal notation in the style "[-Jddd.ddd", 

where the number of digits after the decimal point is equal to the precision 
specification. If the precision is missing, six digits are output; if the precision is expli¬ 
citly 0, no decimal point appears. 

e, E The float or double arg is converted'in the style "[-]d.ddde±ddd", where there is one 

digit before the decimal point and the number of digits after it is equal to the preci¬ 
sion; when the precision is missing, six digits are produced; if the precision is zero, no 
decimal point appears. The E format code will produce a number with E instead of e 
introducing the exponent. The exponent always contains exactly three digits. 
g,G The float or double arg is printed in style f or e (or in style E in the case of a G for¬ 

mat code), with the precision specifying the number of significant digits. The style 
used depends on the value converted: style e will be used only if the exponent result¬ 
ing from the conversion is less than -4 or greater than the precision. Trailing zeroes 
are removed from the result; a decimal point appears only if it is followed by a digit, 
c The character arg is printed. 

s The arg is taken to be a string (character pointer) and characters from the string are 

printed until a null character (\ 0 ) is encountered or the number of characters indi¬ 
cated by the precision specification is reached. If the precision is missing, it is taken to 
be infinite, so all characters up to the first null character are printed. A NULL value 
for arg will yield undefined results. 

% Print a %; no argument is converted. 

In no case does a non-existent or small field width cause truncation of a field; if the result of a 
conversion is wider than the field width, the field is simply expanded to contain the conversion 
result. Characters generated by print/ and /print/ are printed as if putc{3S) had been called. 

EXAMPLES 

To print a date and time in the form "Sunday, July 3, 10:02", where weekday and month are 
pointers to null-terminated strings: 
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printf("%s, %s %d, %d:%.2d", weekday, month, day, hour, min); 
To print tt to 5 decimal places: 

printf("pi = %.5f", 4 * atan(l.O)); 

SEE ALSO 

ecvt(3C), putc(3S), scanf(3S), stdio(3S), and vprintf(3S). 
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NAME 

printmsg, fprintmsg, sprintmsg - print formatted output with numbered arguments 
SYNOPSIS 

^include <stdio.h> 

int printmsg (format [ , arg ] ... ) 

char *format; 

int fprintmsg (stream, format [ , arg ] ... ) 

FILE ^stream; 
char *format; 

int sprintmsg (s, format [ , arg ] ... ) 

char ♦s, ^format; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: HP 

Native Language Support: 

8-bit data, customs, messages 

DESCRIPTION 

Printmsg , fprintmsg , and sprintmsg are derived from their counterparts in printf(3S), with the 
amplification that the conversion character % is replaced by the sequence %digit% . Digit is a 
decimal digit n in the range 1-9, and indicates that this conversion should be applied to the nth 
argument, rather than to the next unused one. All other aspects of formatting are unchanged. 
All conversion specifications must contain the %digit$ sequence, and it is the user’s responsibility 
to make sure the numbering is correct. All parameters must be used exactly once. 

EXAMPLE 

To create a language independent date and time printing routine we would write 
printmsg(format, weekday, month, day, hour, min); 

For American usage format would be a pointer to the string 
"%l$s, %2$s %3$d, %4$d:%5$.2d" 
and for German usage to a string 

"%l$s, %3$d %2$s %4$d:%5$.2d" 

the resulting outputs will be "Sunday, July 3, 10:02", and "Sonntag, 3 Juli 10:02" , assuming 
that the proper strings have been passed in. 

SEE ALSO 

getmsg(3C), printf(3S), hpnls(7). 
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NAME 

putc, putchar, fputc, putw - put character or word on a stream 
SYNOPSIS 

#include <stdio.h> 

int putc (c, stream) 
int c; 

FILE ^stream; 

int putchar (c) 
int c; 

int fputc (c, stream) 
int c; 

FILE ^stream; 

int putw (w, stream) 
int w; 

FILE ^stream; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Putc writes the character c onto the output stream (at the position where the file pointer, if 
defined, is pointing). Putchar(c) is defined as putc{c, stdoui). Putc and putchar are macros. 

Fputc behaves like putc, but is a genuine function rather than a macro; it may therefore be used 
as an argument. Fputc runs more slowly than putc, but it takes less space per invocation and its 
name can be passed as an argument to a function. 

Putw writes the word (i.e., int in C) w to the output stream (at the position at which the file 
pointer, if defined, is pointing). The size of a word is the size of an integer and varies from 
machine to machine. Putw neither assumes nor causes special alignment in the file. 

Output streams, with the exception of the standard error stream stderr, are by default buffered if 
the output refers to a file and line-buffered if the output refers to a terminal. The standard error 
output stream stderr is by default unbuffered, but use of freopen (see fopen(3S)) will cause it to 
become buffered or line-buffered. When an output stream is unbuffered, information is queued for 
writing on the destination file or terminal as soon as written; when it is buffered, many characters 
are saved up and written as a block. When it is line-buffered, each line of output is queued for 
writing on the destination terminal as soon as the line is completed (that is, as soon as a new-line 
character is written or terminal input is requested). Fflush can also be used to explicitly write the 
buffer. Setbuf{3S) or setvbuf{3S) may be used to change the stream’s buffering strategy. 

SEE ALSO 

fclose(3S), ferror(3S), fopen(3S), fwrite(38), getc(3S), fread(3S), printf(3S), puts(3S), setbuf(3S). 
DIAGNOSTICS 

On success, these functions each return the value they have written. On failure, they return the 
constant EOF. This will occur if the file stream is not open for writing or if the output file cannot 
be grown. Because EOF is a valid integer, /error(3S) should be used to detect putw errors. 

Line buffering may cause confusion or malfunctioning of programs which use standard I/O rou¬ 
tines but use read(2) themselves to read from standard input. In cases where a large amount of 
computation is done after printing part of a line on an output terminal, it is necessary to ffiush(3) 
the standard output before going off and computing so that the output will appear. 

BUGS 

Because it is implemented as a macro, putc treats incorrectly a stream argument with side effects. 
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In particular, putc(c, *f++); doesn’t work sensibly. Fputc should be used instead. 

Because of possible differences in word length and byte ordering, files written using putw are 
machine-dependent, and may not be read using getw on a different (non-HP-UX) processor. For 
this reason putw should be used with care. 
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NAME 

putenv - change or add value to environment 
SYNOPSIS 

int putenv (string) 
char *string; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

String points to a string of the form ‘^name—value. ” Putenv makes the value of the environment 
variable name equal to value by altering an existing variable or creating a new one. In either 
case, the string pointed to by string becomes part of the environment, so altering the string will 
change the environment. The space used by string is no longer used once a new string-defining 
name is passed to putenv. 

DIAGNOSTICS 

Putenv returns non-zero if it was unable to obtain enough space via malloc for an expanded 
environment, otherwise zero. 

SEE ALSO 

exec(2), getenv(3C), malloc(3C), environ(5). 

WARNINGS 

Putenv manipulates the environment pointed to by environ, and can be used in conjunction with 
getenv. However, envp (the third argument to main) is not changed. 

This routine uses malloc (SC) to enlarge the environment. 

After putenv is called, environmental variables are not in alphabetical order. 

A potential error is to call putenv with an automatic variable as the argument, then exit the cal¬ 
ling function while string is still part of the environment. 
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NAME 

putpwent - write password file entry 
SYNOPSIS 

^include <pwd.h> 

^include <stdio.h> 

int putpwent (p, f) 
struct passwd *p; 

FILE tf; 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

Putpwent is the inverse of getpw€nt{3C). Given a pointer to a passwd structure as created by 
getpwent (or getpwuid or getpwnam), putpwent writes a line on the stream /, which matches the 
format of /etc/passwd. 

DIAGNOSTICS 

Putpwent returns non-zero if an error was detected during its operation, otherwise zero. 

SEE ALSO 

getpwent (3C). 

WARNING 

The above routine uses <stdio.h>, which causes it to increase the size of programs, not otherwise 
using standard I/O, more than might be expected. 
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NAME 

puts, fputs - put a string on a stream 

SYNOPSIS 

#include <stdio.h> 

int puts (s) 
char *s; 

int fputs (s, stream) 
char *s; 

FILE ^stream; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Puts writes the null-terminated string pointed to by s, followed by a new-line character, to the 
standard output stream stdout. 

Fputs writes the null-terminated string pointed to by s to the named output stream. 

Neither function writes the terminating null character. Note that puts appends a new-line char¬ 
acter, but fputs does not. 

DIAGNOSTICS 

Both routines return EOF on error. This will happen if the routines try to write on a file that has 
not been opened for writing. 

SEE ALSO 

ferror(3S), fopen(3S), fread(3S), printf(3S), putc(3S). 

NOTES 

Puts appends a new-line character while fputs does not. 
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NAME 

qsort - quicker sort 
SYNOPSIS 

void qsort ((char *) base, nel, sizeof (*base), compar) 
unsigned nel; 
int (*compar)( ); 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Qsort is an implementation of the quicker-sort algorithm. It sorts vectors of arbitrarily-sized ele¬ 
ments based on user-supplied size information and a comparison routine, in place 

Base points to the element at the base of the table. Nel is the number of elements in the table. 
Compar is the name of the comparison function, which is called with two arguments that point to 
the elements being compared. The function passed as compar must return an integer less than, 
equal to, or greater than zero as a consequence of whether its first argument is to be considered 
less than, equal to, or greater than the second. This is the same return convention that strcmp 
uses. 

NOTES 

The pointer to the base of the table should be of type pointer-to-element, and cast to type 
pointer-to-character. 

The comparison function need not compare every byte, so arbitrary data may be contained in the 
elements in addition to the values being compared. 

The order in the output of two items which compare as equal is unpredictable. 

SEE ALSO 

sort(l), bsearch(3C), lsearch(3C), string(3C). 

BUGS 

If width is zero, a divide-by-zero error is generated. 
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NAME 

rand, srand - simple random-number generator 

SYNOPSIS 

int rand ( ) 

void srand (seed) 
unsigned seed; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Rand uses a multiplicative congruential random-munber generator with period 2^^ that returns 
successive pseudo-random nmnbers in the range from 0 to 

Srand can be called at any time to reset the random-number generator to a random starting 
point. The generator is initially seeded with a value of 1. 

NOTE 

The spectral properties of rand leave a great deal to be desired. Drand48{3C) provides a much 
better, though more elaborate, random-number generator. 

SEE ALSO 

drand48(3C). 
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NAME 

regcmp, regex - compile and execute regular expression 
SYNOPSIS 

char *regcmp (stringl [, string2, ...], (char ♦) 0 ) 
char *stringl, *string2, .. 

char *regex (re, subject[, retO, ...]) 
char *re, ^subject, *retO, .. 

extern char *_loci; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Regcmp compiles a regular expression and returns a pointer to the compiled form. Malloc(3C) is 
used to create space for the vector. It is the user’s responsibility to free unneeded space so allo¬ 
cated. A NULL return from regcmp indicates an incorrect argument. Regcmp{l) has been written 
to generally preclude the need for this routine at execution time. 

Regex executes a compiled pattern against the subject string. Additional arguments are passed to 
receive values back. Regex returns NULL on failure or a pointer to the next unmatched character 

on success. A global character pointer_ loci points to where the match began. Regcmp and 

regex were mostly borrowed from the editor, ed(l); however, the syntax and semantics have been 
changed slightly. The following are the valid symbols and their associated meanings. 

[ ] * / These symbols retain their current meaning. 

$ Matches the end of the string; \n matches a new-line. 

Within brackets the minus means through. For example, [a-z] is equivalent to 
[abed.. .xyz]. The - can appear as itself only if used as the first or last character. 
For example, the character class expression []-] matches the characters ] and -. 

+ A regular expression followed by + means one or more times. For example, [0-9]+ is 

equivalent to [0-9] [0-9]*. 

{m} {m,} {m,u} 

Integer values enclosed in {} indicate the number of times the preceding regular 
expression is to be applied. The value m is the minimum number and w is a number, 
less than 256, which is the maximum. If only m is present (e.g., {m}), it indicates the 
exact number of times the regular expression is to be applied. The value {m,} is analo¬ 
gous to {m,infinity}. The plus (+) and star (*) operations are equivalent to {!,} and 
{0,} respectively. 

( ... )$n The value of the enclosed regular expression is to be returned. The value will be stored 
in the (n+ljth. argument following the subject argument. At most ten enclosed regular 
expressions are allowed. Regex makes its assignments unconditionally. 

(...) Parentheses are used for grouping. An operator, e.g., *, -f, { }, can work on a single 
character or a regular expression enclosed in parentheses. For example, (a*(cb-t-)*)$0. 

By necessity, all the above defined symbols are special. They must, therefore, be escaped to be 
used as themselves. 

EXAMPLES 

Example 1: 

char ^cursor, *newcursor, *ptr; 

newcursor = regex((ptr = regcmp(""\n", 0)), cursor); 
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free(ptr); 

This example will match a leading new-line in the subject string pointed at by cursor. 

Example 2: 

char ret0[9]; 

char *newcursor, ♦name; 

name = regcmp("([A-Za-z][A-za-z0-9_]{0,7})$0", 0); 
newcursor = regex(name, 'T23Testing321", retO); 

This example will match through the string “Testing3” and will return the address of the charac¬ 
ter after the last matched character (cursor+11). The string “Testing3” will be copied to the 
character array retO. 

Example 3: 

^include "file.i" 

char ^string, *newcursor; 

newcursor = regex(name, string); 

This example applies a precompiled regular expression in file.i (see regcmp{l)) against string. 

This routine is kept in /lib/libPW.a. 

SEE ALSO 

ed(l), regcmp(l), malloc(3C). 

BUGS 

The user program may run out of memory if regcmp is called iteratively without freeing the vec¬ 
tors no longer required. The following user-supplied replacement for malloc {3C) reuses the same 
vector saving time and space: 

/♦ user’s program */ 

char ♦ 
malloc (n) 
unsigned n; 

{ 

static char rebuf[512]; 

return (n <= sizeof rebuf) ? rebuf : NULL; 

} 
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NAME 

scanf, fscanf, sscanf - formatted input conversion, read from stream file 
SYNOPSIS 

^include <stdio.h> 

int scanf (format [ , pointer ] ... ) 

char *format; 

int fscanf (stream, format [ , pointer ] ... ) 

FILE ^stream; 
char ♦format; 

int sscanf (s, format [ , pointer ] ... ) 

char ♦s, ♦format; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Scanf reads from the standard input stream stdin. Fscanf reads from the named input stream. 
Sscanf reads from the character string 5 . Each function reads characters, interprets them accord¬ 
ing to a format, and stores the results in its arguments. Each expects, as arguments, a control 
string format described below, and a set of pointer arguments indicating where the converted 
input should be stored. 

The control string usually contains conversion specifications, which are used to direct interpreta¬ 
tion of input sequences. The control string may contain: 

1. White-space characters (blanks, tabs, new-lines, or form-feeds) which, except in two cases 
described below, cause input to be read up to the next non-white-space character. 

2. An ordinary character (not %), which must match the next character of the input stream. 

3. Conversion specifications, consisting of the character %, an optional assignment suppressing 
character ♦, an optional numerical maximum field width, an optional 1 (ell) or h indicating the 
size of the receiving variable, and a conversion code. 

A conversion specification directs the conversion of the next input field; the result is placed in the 
variable pointed to by the corresponding argument, unless assignment suppression was indicated 
by ♦. The suppression of assignment provides a way of describing an input field which is to be 
skipped. An input field is defined as a string of non-space characters; it extends to the next inap¬ 
propriate character or until the field width, if specified, is exhausted. For all descriptors except 
“[” and “c”, white space leading an input field is ignored. 

The conversion code indicates the interpretation of the input field; the corresponding pointer 
argument must usually be of a restricted type. For a suppressed field, no pointer argument is 
given. The following conversion codes are legal: 

% a single % is expected in the input at this point; no assignment is done, 
d a decimal integer is expected; the corresponding argument should be an integer pointer, 
u an unsigned decimal integer is expected; the corresponding argument should be an 
unsigned integer pointer. 

o an octal integer is expected; the corresponding argument should be an integer pointer. 

X a hexadecimal integer is expected; the corresponding argument should be an integer 

pointer. 

e,f,g a floating point number is expected; the next field is converted accordingly and stored 

through the corresponding argument, which should be a pointer to a float. The input 

format for floating point numbers is an optionally signed string of digits, possibly contain¬ 
ing a decimal point, followed by an optional exponent field consisting of an E or an e, fol¬ 
lowed by an optional or space, followed by an integer. 
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s a character string is expected; the corresponding argument should be a character pointer 

pointing to an array of characters large enough to accept the string and a terminating \0, 
which will be added automatically. The input field is terminated by a white-space char¬ 
acter. Note that scan/will not read a null string, 
c a character is expected; the corresponding argument should be a character pointer. The 
normal skip over white space is suppressed in this case; to read the next non-space char¬ 
acter, use %ls. If a field width is given, the corresponding argument should refer to a 
character array; the indicated number of characters is read. 

[ indicates string data and the normal skip over leading white space is suppressed. The left 

bracket is followed by a set of characters, which we will call the scanset, and a right 
bracket; the input field is the maximal sequence of input characters consisting entirely of 
characters in the scanset. The circumflex ("), when it appears as the first character in 
the scanset, serves as a complement operator and redefines the scanset as the set of all 
characters not contained in the remainder of the scanset string. There are some conven¬ 
tions used in the construction of the scanset. A range of characters may be represented 
by the construct first-last, thus [0123456789] may be expressed [0-9]. Using this conven¬ 
tion, first must be lexically less than or equal to last, or else the dash will stand for itself. 
The dash will also stand for itself whenever it is the first or the last character in the scan¬ 
set. To include the right square bracket as an element of the scanset, it must appear as 
the first character (possibly preceded by a circumflex) of the scanset, and in this case it 
will not be syntactically interpreted as the closing bracket. The corresponding argument 
must point to a character array large enough to hold the data field and the terminating 
\0, which will be added automatically. At least one character must match for this 
conversion to be considered successful. 

The conversion characters d, u, o, and x may be preceded by 1 or h to indicate that a pointer to 
long or to short rather than to int is in the argument list. Similarly, the conversion characters 
e, f, and g may be preceded by 1 to indicate that a pointer to double rather than to float is in 
the argument list. The 1 or h modifier is ignored for other conversion characters. 

Scan/ conversion terminates at EOF, at the end of the control string, or when an input character 
conflicts with the control string. In the latter case, the offending character is left unread in the 
input stream. 

Scan/ returns the number of successfully matched and assigned input items; this number can be 
zero in the event of an early conflict between an input character and the control string. If the 
input ends before the first conflict or conversion, EOF is returned. 

EXAMPLES 

The call: 

int i, n; float x; char name[50]; 
n = scanf ("%d%f%s", ki, kx, name); 

with the input line: 

25 54.32E-1 thompson 

will assign to n the value 3, to ^ the value 25, to x the value 5.432, and name will contain 
thompson\0. Or: 

int i; float x; char name[50]; 

(void) scanf ("%2d%f%*d %[0-9]", &;i, &;x, name); 

with input: 

56789 0123 56a72 

will assign 56 to i, 789.0 to x, skip 0123, and place the string 56\0 in name. The next call to 
getchar (see ^eic(3S)) will return a. 
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SEE ALSO 

getc(3S), printf(3S), strtod(3C), strtol(3C). 

NOTE 

Trailing white space (including a new-line) is left unread unless matched in the control string. 
DIAGNOSTICS 

These functions return EOF on end of input and a short count for missing or illegal data items. 

BUGS 

The success of literal matches and suppressed assignments is not directly determinable. 
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NAME 

setbuf, setvbuf - assign buffering to a .stream file 
SYNOPSIS 

#include <stdio.h> 

void setbuf (stream, buf) 

FILE ^stream; 
char *buf; 

int setvbuf (stream, buf, type, size) 

FILE ^stream; 
char *buf; 
int type, size; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Setbuf may be used after a stream has been opened but before it is read or written. It causes the 
array pointed to by buf to be used instead of an automatically allocated buffer. If buf is the NULL 
pointer input/output will be completely unbuffered. 

A constant BUFSIZ, defined in the <stdio.h> header file, tells how big an array is needed: 
char buf [BUFSIZ]; 

Setvbuf may be used after a stream has been opened but before it is read or written. Type deter¬ 
mines how stream will be buffered. Legal values for type (defined in stdio.h) are: 

_IOFBF causes input/output to be fully buffered. 

_IOLBF causes output to be line buffered; the buffer will be flushed when a newline is writ¬ 
ten, the buffer is full, or input is requested. 

_JONBF causes input/output to be completely unbuffered. 

If buf is not the NULL pointer, the array it points to will be used for buffering instead of an 
automatically allocated buffer (from maUoc{ZG) or memallc{2)). Size specifies the size of the 
buffer to be used. The constant BUFSIZ in <stdio.h> is suggested as a good buffer size. If 
input/output is unbuffered, buf and size are ignored. 

By default, output to a terminal is line buffered and all other input/output is fully buffered. 

HARDWARE DEPENDENCIES 

Series 500: 

The system call memallc{2) is used instead of malloc. 

SEE ALSO 

fopen(3S), getc(3S), malloc(3C), putc(3S), stdio(3S). 

DIAGNOSTICS 

If an illegal value for type or size is provided, setvbuf returns a non-zero value. Otherwise, the 
value returned will be zero. 


NOTE 

A common source of error is allocating buffer space as an "automatic" variable in a code block, 
and then failing to close the stream in the same block. 
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NAME 

setjmp, longjmp - non-local goto 
SYNOPSIS 

#include <setjmp.h> 

int setjmp (env) 
jmp_buf env; 

void longjmp (env, val) 
jmp_buf env; 
int val; 

int —setjmp (env) 
jmp—buf env; 

void —longjmp(env, val) 
jmp—buf env; 
int val; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

These functions are useful for dealing with errors and interrupts encountered in a low-level sub¬ 
routine of a program. 

Setjmp saves its stack environment in env (whose type, jmp—buf^ is defined in the <setjmp.h> 
header file) for later use by longjmp. It returns the value 0. 

Longjmp restores the environment saved by the last call of setjmp with the corresponding env 
argument. After longjmp is completed, program execution continues as if the corresponding call 
of setjmp (which must not itself have returned in the interim) had just returned the value val. 
Longjmp cannot cause setjmp to return the value 0. If longjmp is invoked with a second argu¬ 
ment of 0, setjmp will return 1. All accessible data have values as of the time longjmp was called. 

Upon the return from a setjmp call caused by a longjmp, the values of any non-static local vari¬ 
ables are undefined. Depending on such values renders code using non-static local variables non¬ 
portable. 

Setjmp and longjmp save and restore the signal mask (see sigvector{2)), while setjmp and 
—longjmp manipulate only the stack and registers. This distinction is only significant for pro¬ 
grams which use sigvector(2), sigblock(2), and/or sigsetmask(2). 

If a longjmp is executed and the environment in which the setjmp was executed no longer exists, 
errors can occur. The conditions under which the environment of the setjmp no longer exists 
include: exiting the procedure which contains the setjmp call, and exiting an inner block with tem¬ 
porary storage (e.g. a block with declarations in C, a with statement in Pascal). This condition 
may or may not be detectable. An attempt is made by determining if the stack frame pointer in 
env points to a location not in the currently active stack. If this is the case, longjmp will return a 
-1. Otherwise, the longjmp will occur, and if the environment no longer exists, the contents of the 
temporary storage of an inner block are unpredictable. This condition may also cause unexpected 
process termination. If the procedure has been exited the results are unpredictable. 

Passing longjmp a pointer to a buffer not created by setjmp, or a buffer that has been modified by 
the user, can cause all the problems listed above, and more. 

Some implementations of Pascal support a try/recover mechanism, which also creates stack 
marker information. If a longjmp operation occurs in a scope which is nested inside a try/recover, 
and the corresponding setjmp is not inside the scope of the try/recover, the recover block will not 
be executed and the currently active recover block will become the one enclosing the setjmp (if 
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there is one). 

NOTE 

A call to longjmp to leave the guaranteed stack space reserved by sigspace (2) may remove the 
guarantee that the ordinary execution of the program will not extend into the guaranteed space. 
It may also cause the program to forever loose its ability to automatically increase the stack size, 
and the program may then be limited to the guaranteed space. 

SEE ALSO 

sigvector(2), sigblock(2), sigsetmask(2), sigspace(2), signal(2). 

WARNING 

If longjmp is called even though env was never primed by a call to setjmp, or when the last such 
call was in a function which has since returned, absolute chaos is guaranteed. 
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NAME 

sinh, cosh, tanh - hyperbolic functions 
SYNOPSIS 

#include <math.h> 

double sinh (x) 
double x; 

double cosh (x) 
double x; 

double tanh (x) 
double x; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Sinh, cosh, and tanh return, respectively, the hyperbolic sine, cosine and tangent of their argu¬ 
ment. These are double-precision routines. 

IMPORTANT NOTE: The corresponding single-precision routines fsinh, fcosh, and ftanh expect 
true single-precision arguments, and therefore cannot be called from standard C. They are pro¬ 
vided for support of FORTRAN (Pascal does not support or use hyperbolic functions). 

DIAGNOSTICS 

Sinh and cosh set errno to ERANGE and return HUGE ( sinh may return -HUGE for negative 
x) when the correct value would overflow. 

Error handling is identical for both single- and double-precision routines, except for one con¬ 
sideration: In any situation where the double-precision routine would return ±HUGE, the 
corresponding single-precision routine returns dbMAXFLOAT. 

These error-handling procedures may be changed with the function matherr[3M). 

SEE ALSO 

matherr(3M). 


float fsinh (x) 
tfloat x; 

float fcosh (x) 
tfloat x; 

float ftanh (x) 

Ifloat x; 

t see important note below 
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NAME 

sleep - suspend execution for interval 
SYNOPSIS 

unsigned long sleep (seconds) 
unsigned long seconds; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

The current process is suspended from execution for the number of seconds specified by the argu¬ 
ment. The actual suspension time may be less than that requested because any caught signal will 
terminate the sleep following execution of that signal’s catching routine. Also, the suspension 
time may be longer than requested by an arbitrary amount due to the scheduling of other activity 
in the system. The value returned by sleep will be the "unslept" amount (the requested time 
minus the time actually slept) in case the caller had an alarm set to go off earlier than the end of 
the requested sleep time, or premature arousal due to another caught signal. 

The routine is implemented by setting an alarm signal and pausing until it (or some other signal) 
occurs. The previous state of the alarm signal is saved and restored. The calling program may 
have set up an alarm signal before calling sleep. If the sleep time exceeds the time till such alarm 
signal, the process sleeps only until the alarm signal would have occurred. The caller’s alarm 
catch routine is executed just before the sleep routine returns. If the sleep time is less than the 
time till such alarm, the prior alarm time is reset to go off at the same time it would have without 
the intervening sleep. 

Seconds must be less than 2^^. 

SEE ALSO 

alarm(2), pause(2), signal(2). 
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NAME 

sputl, sgetl - access long integer data in a machine-independent fashion. 

SYNOPSIS 

void sputl (value, buffer) 
long value; 
char *buffer; 

long sgetl (buffer) 
char *buffer; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Sputl takes the four bytes of the long integer value and places them in memory starting at the 
address pointed to by buffer. The ordering of the bytes is the same across all machines. 

Sgetl retrieves the four bytes in memory starting at the address pointed to by buffer and returns 
the long integer value in the byte ordering of the host machine. 

The combination of sputl and sgetl provides a machine-independent way of storing long numeric 
data in a file in binary form without conversion to characters. 

A program which uses these functions must be loaded with the object-file access routine library 

libld.a. 
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NAME 

ssignal, gsignal - software signals 

SYNOPSIS 

#include <signal.h> 

int (^ssignal (sig, action))( ) 
int sig, (*action)( ); 

int gsignal (sig) 
int sig; 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Ssignal and gsignal implement a software facility similar to signal{2). This facility is used by the 
Standard C Library to enable users to indicate the disposition of error conditions, and is also 
made available to users for their own purposes. 

Software signals made available to users are associated with integers in the inclusive range 1 
through 15. A call to ssignal associates a procedure, action, with the software signal sig; the 
software signal, sig, is raised by a call to gsignal. Raising a software signal causes the action 
established for that signal to be taken. 

The first argument to ssignal is a number identifying the type of signal for which an action is to 
be established. The second argument defines the action; it is either the name of a (user-defined) 
action function or one of the manifest constants SIG_DFL (default) or SIG_IGN (ignore). Ssig¬ 
nal returns the action previously established for that signal type; if no action has been established 
or the signal number is illegal, ssignal returns SIG_JDFL. 

Gsignal raises the signal identified by its argument, sig: 

If an action function has been established for sig, then that action is reset to SIG JDFL and 
the action function is entered with argument sig. Gsignal returns the value returned to it 
by the action function. 

If the action for sig is SIG_IGN, gsignal returns the value 1 and takes no other action. 

If the action for sig is SIG_DFL, gsignal returns the value 0 and takes no other action. 

If sig has an illegal value or no action was ever specified for sig, gsignal returns the value 0 
and takes no other action. 

SEE ALSO 

signal(2). 

NOTES 

There are some additional signals with numbers outside the range 1 through 15 which are used by 
the Standard C Library to indicate error conditions. Thus, some signal numbers outside the range 
1 through 15 are legal, although their use may interfere with the operation of the Standard C 
Library. 
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NAME 

stdio - standard buffered input/output stream file package 
SYNOPSIS 

#mclude <stdio.h> 

FILE *stdin, ♦stdout, *stderr; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

The fimctions described in the entries of sub-class 3S of this manual constitute an efficient, user- 
level I/O buffering scheme. The in-line macros getc{SS) and putc(3S) handle characters quickly. 
The macros getchar and putchar, and the higher-level routines fgetc, /gets, fprintf^ fputc, fputs^ 
fread^ fscanf^ /write, gets, getw, print/, puts, putw, and scan/ all use or act as if they use getc and 
putc', they can be freely intermixed. 

A file with associated buffering is called a stream and is declared to be a pointer to a defined type 
FILE. Popew(3S) creates certain descriptive data for a stream and returns a pointer to designate 
the stream in all further transactions. Normally, there are three open streams with constant 
pointers declared in the <stdio.h> header file and associated with the standard open files: 

stdin standard input file 

stdout standard output file 

stderr standard error file 

A constant NULL (0) designates a nonexistent pointer. 

An integer-constant EOF (-1) is returned upon end-of-file or error by most integer functions that 
deal with streams (see the individual descriptions for details). 

An integer constant BUFSIZ specifies the size of the buffers used by the particular implementa¬ 
tion. 

Any program that uses this package must include the header file of pertinent macro definitions, as 
follows: 

#include <stdio.h> 

The functions and constants mentioned in the entries of sub-class 3S of this manual are declared 
in that header file and need no further declaration. The constants and the following "functions" 
are implemented as macros (redeclaration of these names is perilous): getc, getchar, putc, 
putchar, /error, /eo/, clearerr, and /ileno. 

A constant _NFILE defines the maximum number of open files allowed per process. 

SEE ALSO 

open(2), close(2), lseek(2), pipe(2), read(2), write(2), ctermid(3S), cuserid(3S), fclose(3S), 
ferror(3S), fopen(3S), fread(3S), fseek(3S), getc(3S), gets(3S), popen(3S), printf(3S), putc(3S), 
puts(3S), scanf(3S), setbuf(3S), system(3S), tmpfile(3S), tmpnam(3S), ungetc(3S). 

DIAGNOSTICS 

Invalid stream pointers will usually cause grave disorder, possibly including program termination. 
Individual function descriptions describe the possible error conditions. 
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NAME 

ftok - standard interprocess communication package 
SYNOPSIS 

^include <sys/types.h> 

#include <sys/ipc.h> 

key_t ftok(path, id) 
char *path; 
char id; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

All interprocess communication facilities require the user to supply a key to be used by the 
msgget{2), semget{2], and shmget{2) system calls to obtain interprocess communication 
identifiers. One suggested method for forming a key is to use the ftok subroutine described below. 
Another way to compose keys is to include the project ID in the most significant byte and to use 
the remaining portion as a sequence number. There are many other ways to form keys, but it is 
necessary for each system to define standards for forming them. If some standard is not adhered 
to, it will be possible for unrelated processes to unintentionally interfere with each other’s opera¬ 
tion. Therefore, it is strongly suggested that the most significant byte of a key in some sense refer 
to a project so that keys do not conflict across a given system. 

Ftok returns a key based on path and id that is usable in subsequent msgget, semget, and shmget 
system calls. Path must be the path name of an existing file that is accessible to the process. Id 
is a character which uniquely identifies a project. Note that ftok will return the same key for 
linked files when called with the same id and that it will return different keys when called with 
the same file name but different ids. 

SEE ALSO 

intro(2), msgget(2), semget(2), shmget(2). 

DIAGNOSTICS 

Ftok returns (key_t) -1 if path does not exist or if it is not accessible to the process. 

WARNING 

If the file whose path is passed to ftok is removed when keys still refer to the file, future calls to 
ftok with the same path and id will return an error. If the same file is recreated, then ftok is likely 
to return a different key than it did the original time it was called. 
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NAME 

strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, strchr, strrchr, strpbrk, strspn, strcspn, 
strtok - character string operations 

SYNOPSIS 

#include <string.h> 

char *strcat (si, s2) 
char *sl, *s2; 

char *strncat (si, s2, n) 
char *sl, *s2; 
int n; 

int strcmp (si, s2) 
char *sl, *s2; 

int strncmp (si, s2, n) 
char *sl, *s2; 
int n; 

char *strcpy (si, s2) 
char *sl, *s2; 

char *strncpy (si, s2, n) 
char ^sl, *s2; 
int n; 

int strlen (s) 
char *s; 

char *strchr (s, c) 
char *s; 
int c; 

char *strrchr (s, c) 
char *s; 
int c; 

char *strpbrk (si, s2) 
char *sl, *s2; 

int strspn (si, s2) 
char *sl, *s2; 

int strcspn (si, s2) 
char *sl, *s2; 

char *strtok (si, s2) 
char *sl, *s2; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

These functions operate on null-terminated strings. The arguments si, s2 and s point to strings 
(arrays of characters terminated by a null character). The functions strcat, strncat, strcpy, and 
strncpy all alter si. These functions do not check for overflow of the array pointed to by si. 

Strcat appends a copy of string s2 to the end of string si. Strncat appends at most n characters. 
It copies less if s2 is shorter than n characters. Each returns a pointer to the null-terminated 
result (the original value of si). 
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Strcmp compares its arguments and returns an integer less than, equal to, or greater than 0, 
according as si is lexicographically less than, equal to, or greater than s2. (NULL values for si 
and s2 are treated the same as pointers to null strings.) Strncmp makes the same comparison but 
looks at at most n characters (n less than or equal to zero yields equality). Both of these routines 
use unsigned char for character comparison. 

Strcpy copies string s2 to si, stopping after the null character has been copied. Strncpy copies 
exactly n characters, truncating s2 or adding null characters to si if necessary. The result will 
not be null-terminated if the length of s2 is n or more. If the lengthe of s2 is less than n, char¬ 
acters from the first null in s2 to the nth character are copied as nulls. Each function returns si. 

Note that strncpy should not be used to copy n bytes of an arbitrary structure. If that structure 
contains a null byte anywhere, strncpy will terminate the copy when it encounters the null byte, 
thus copying fewer than n bytes. 

Strlen returns the number of characters in s, not including the terminating null character. 

Strchr (strrchr) returns a pointer to the first (last) occurrence of character c (an 8-bit ASCII 
value) in string s, or a NULL pointer if c does not occur in the string. The null character ter¬ 
minating a string is considered to be part of the string. 

Strpbrk returns a pointer to the first occurrence in string si of any character from string s2, or a 
NULL pointer if no character from s2 exists in si. 

Strspn (strcspn) returns the length of the initial segment of string si which consists entirely of 
characters from (not from) string s2. 

Strtok considers the string si to consist of a sequence of zero or more text tokens separated by 
spans of one or more characters from the separator string s2. The first call (with pointer si 
specified) returns a pointer to the first character of the first token, and will have written a null 
character into si immediately following the returned token. The function keeps track of its posi¬ 
tion in the string between separate calls, so that subsequent calls (which must be made with the 
first argument a NULL pointer) will work through the string si immediately following that token. 
In this way subsequent calls will work through the string si until no tokens remain. The separa¬ 
tor string s2 may be different from call to call. When no token remains in si, a NULL pointer is 
returned. 

HARDWARE DEPENDENCIES 

Series 200: 

N is limited by the process size. 

Series 500: 

N is limited to about 500 Mbytes. 

NOTE 

For user convenience, all these functions are declared in the optional <string.h> header file. 

BUGS 

The copy operations cannot check for overflow of any receiving string. NULL destinations cause 
errors; NULL sources are treated as zero-length strings. 

Character movement is performed differently in different implementations. Thus overlapping 
moves may yield surprises. 
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NAME 

strtod, atof, nl_strtod, n]_atof - convert string to double-precision number 

SYNOPSIS 

double strtod (str, ptr) 
char ♦str, ♦♦ptr; 

double atof (str) 
char ♦str; 

double nl_strtod (str, ptr, langid) 
char ♦str, ♦♦ptr; 
int langid; 

double nl_atof (str, langid) 
char ♦str; 
int langid; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

Native Language Support: 

8-bit data, customs, messages 

DESCRIPTION 

Strtod returns as a double-precision floating-point number the value represented by the character 
string pointed to by str. The string is scanned up to the flrst unrecognized character. 

Strtod recognizes an optional string of “white-space” characters (as defined by isspace in 
ctype{3C)), then an optional sign, then a string of digits optionally containing a decimal point 
then an optional e or E followed by an optional sign or space, followed by an integer. 

If the value of ptr is not (char ♦♦)NULL, a pointer to the character terminating the scan is 
returned in the location pointed to by ptr. If no number can be formed, *ptr is set to str, and 
zero is returned. 

Atof (str) is equivalent to strtodfstr, (char **)NULL). 

Nl—strtod and nl—atof are similar to the above routines, but use langid to determine what the 
radix character should be (e.g. or If langid is not valid, or information for langid has not 
been installed, the radix character defaults to a period. 

SEE ALSO 

ctype(3C), scanf(3S), strtol(3C), hpnls(7), langid(7). 

DIAGNOSTICS 

If the correct value would cause overflow, ±HUGE is returned (according to the sign of the value), 
and errno is set to ERANGE. 

If the correct value would cause underflow, zero is returned and errno is set to ERANGE. 
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NAME 

strtol, atol, atoi - convert string to integer 
SYNOPSIS 

long strtol (str, ptr, base) 
char *str, **ptr; 
int base; 

long atol (str) 
char *str; 

int atoi (str) 
char ♦str; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Strtol returns as a long integer the value represented by the character string pointed to by str. 
The string is scanned up to the first character inconsistent with the base. Leading “white-space” 
characters (as defined by isspace in ctype{3C)) are ignored. 

If the value of ptr is not (char ♦♦)NULL, a pointer to the character terminating the scan is 
returned in the location pointed to by ptr. If no integer can be formed, that location is set to str, 
and zero is returned. 

If base is positive (and not greater than 36), it is used as the base for conversion. After an 
optional leading sign, leading zeros are ignored, and “Ox” or “OX” is ignored if base is 16. 

If base is zero, the string itself determines the base thusly: After an optional leading sign a leading 
zero indicates octal conversion, and a leading “Ox” or “OX” hexadecimal conversion. Otherwise, 
decimal conversion is used. 

Atol(str) is equivalent to strtol(str, (char **)NULL, 10). 

Atoi(str) is equivalent to (int) strtol(str, (char **)NULL, 10). 

SEE ALSO 

atof(3C), ctype(3C), scanf(3S), strtod(3C). 

HARDWARE DEPENDENCIES 
Series 200/500: 

Atoi and atol are identical. 

BUGS 

Overflow conditions are ignored. 
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NAME 

swab - swap bytes 

SYNOPSIS 

void swab (from, to, nbytes) 
char *from, *to; 
int nbytes; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Swab copies nbytes bytes pointed to by from to the array pointed to by to, exchanging adjacent 
even and odd bytes. It is useful for carrying binary data between byte-swapped and non-byte- 
swapped machines. Nbytes should be even and non-negative. If nbytes is odd and positive swab 
uses nbytes-1 instead. If nbytes is negative, swab does nothing. 
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NAME 

system - issue a shell command 
SYNOPSIS 

#include <stdio.h> 

int system (string) 
char ^string; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

System causes the string to be given to s/i(l) as input, as if the string had been typed as a com¬ 
mand at a terminal. The current process waits until the shell has completed, then returns the 
exit status of the shell. 

FILES 

/bin/sh 

SEE ALSO 

sh(l), exec(2). 

DIAGNOSTICS 

System forks to create a child process that in turn exec’s /bin/sh in order to execute string. If 
the fork or exec fails, system returns a negative value and sets errno. 
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NAME 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - emulate /etc/termcap access routines 

SYNOPSIS 

tgetent(bp, name) 
char *bp, *name; 

tgetnum(id) 
char *id; 

tgetflag(id) 
char *id; 

char * 

tgetstr(id, area) 
char *id, **area; 

char * 

tgoto (cm, destcol, destline) 
char *cm; 

tputs(cp, affcnt, outc) 
register char *cp; 
int affcnt; 
int (*outc)(); 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Termcap(8) functions extract and use capabilities from the compiled terminal capability data 
bases (see terminfo(5)). They are emulation routines that are provided as a part of the curses(8X) 
library. 

Tgetent extracts the compiled entry for terminal name into buffers accessible by the programmer. 
Unlike previous termcap routines, all capability strings (except cursor addressing and padding 
information) are already compiled and stored internally upon return from tgetent. The buffer 
pointer bp is redundant in the emulation, and is ignored. It should not be relied upon to point to 
meaningful information. Tgetent returns -1 if it cannot access the terminfo directory, 0 if there is 
no capability file for name, and 1 if all goes well. If a TERMINFO environment variable is set, 
tgetent first looks for TERMINFO/?/name (where ? is the first character of name), and if that file 
is not accessible, it looks for /usr/lib/terminfo/?/name. 

Tgetnum gets the numeric value of capability id, returning -1 if it is not given for the terminal. 
Tgetnum is useful only with capabilities having numeric values. 

Tgetflag returns 1 if the specified capability is present in the terminal’s entry, and 0 if it is not. 
Tgetflag is useful only with capabilities that are boolean in nature (i.e. either present or missing in 
terminfo{b)). 

Tgetstr returns a pointer to the string value of capability id. In addition, if area is not a NULL 
pointer, tgetstr will place the capability in the buffer at area and advance the area pointer. The 
returned string capability is compiled except for cursor addressing and padding information. 
Tgetstr is useful only with capabilities having string values. Tgetstr returns a NULL pointer if the 
capability is not available on the terminal or id is not a string capability. 

Tgoto returns a cursor addressing string decoded from cm to go to column destcol in line destline. 
(Programs which call tgoto should be sure to turn off the TABS bit(s), since tgoto may now out¬ 
put a tab. See termio{4). Note that programs using termcap should in general turn off TABS 
anyway since some terminals use control-I for other functions, such as nondestructive space.) If a 
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% sequence is given which is not understood, then tgoto returns OOPS. 

Tputs decodes the padding information of the string cp. Affcnt gives the number of lines affected 
by the operation, or 1 if this is not applicable. Outc is a routine which is called with each charac¬ 
ter in turn. The terminfo variable pad_char should contain a pad character to be used (from 
the pc capability) if a null ("@) is inappropriate. 

FILES 

/usr/lib/libcurses.a -Icurses library 

/usr/lib/terminfo/?/* data bases 

SEE ALSO 

ex(l), termio(4), terminfo(5). 
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NAME 

tmpfile - create a temporary file 
SYNOPSIS 

^include <stdio.h> 

FILE ♦tmpfile () 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

Tmpfile creates a temporary file using a name generated by tmpnam(3S)^ and returns a 
corresponding FILE pointer. If the file cannot be opened, an error message is printed using 
perror(3C), and a NULL pointer is returned. The file will automatically be deleted when the pro¬ 
cess using it terminates. The file is opened for update ("w+"). 

SEE ALSO 

creat(2), unlink(2), fopen(3S), mktemp(3C), perror(3C), tmpnam(3S). 
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NAME 

tmpnam, tempnam - create a name,for a temporary file 
SYNOPSIS 

^include <stdio.h> 

char * tmpnam (s) 
char ^s; 

char ♦tempnam (dir, pfx) 
char ♦dir, ♦pfx; 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

These functions generate file names that can safely be used for a temporary file. 

Tmpnam always generates a file name using the path-prefix defined as P_tmpdir in the 
<stdio.h> header file unless <stdio.h> has been locally modified. If s is NULL, tmpnam leaves its 
result in an internal static area and returns a pointer to that area. The next call to tmpnam will 
destroy the contents of the area. If s is not NULL, it is assumed to be the address of an array of 
at least L_tmpnam bytes, where L_tmpnam is a constant defined in <stdio.h>\ tmpnam 
places its result in that array and returns s. 

Tempnam allows the user to control the choice of a directory. The argument dir points to the 
name of the directory in which the file is to be created. If dir is NULL or points to a string which 
is not a name for an appropriate directory, the path-prefix defined as P_tmpdir in the 
<stdio.h> header file is used. If that directory is not accessible, /tmp will be used as a last 
resort. This entire sequence can be up-staged by providing an environment variable TMPDIR in 
the user’s environment, whose value is the name of the desired temporary-file directory. 

Many applications prefer their temporary files to have certain favorite initial letter sequences in 
their names. Use the pfx argument for this. This argument may be NULL or point to a string of 
up to five characters to be used as the first few characters of the temporary-file name. 

Tempnam uses malloc[2>G) to get space for the constructed file name, and returns a pointer to 
this area. Thus, any pointer value returned from tempnam may serve as an argument to free (see 
malloc(SG)). If tempnam cannot return the expected result for any reason, i.e. maUoc(3G) failed, 
or none of the above mentioned attempts to find an appropriate directory was successful, a NULL 
pointer will be returned. 

NOTES 

These functions generate a different file name each time they are called. 

Files created using these functions and either fopen{3S) or creat{2) are temporary only in the 
sense that they reside in a directory intended for temporary use, and their names are unique. It is 
the user’s responsibility to use unlink (2) to remove the file when its use is ended. 

File names are initially of the form [a-z] [a-z] [a-z]XXXXXX in the directory specified by either dir 
(in tempnam) or L_tmpnam (in tmpnam) and are then passed to mktemp before returning the 
result. 

SEE ALSO 

creat(2), unlink(2), fopen(3S), malloc(3C), mktemp(3C), tmpfile(3S). 

BUGS 

If called more than 17,576 times in a single process, these functions will start recycling previously 
used names. 

Between the time a file name is created and the file is opened, it is possible for some other process 
to create a file with the same name. This can never happen if that other process is using these 
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functions or mktemp^ and the file names are chosen so as to render duplication by other means 
unlikely. 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric functions 

SYNOPSIS 

^include <math.h> 

double sin (x) 
double x; 

double cos (x) 
double x; 

double tan (x) 
double x; 

double asin (x) 
double x; 

double acos (x) 
double x; 

double atan (x) 
double x; 

double atan2 (y, x) 
double y, x; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Sin, cos and tan return respectively the sine, cosine and tangent of their argument, x, measured 
in radians. 

Asin returns the arcsine of x, in the range -7r/2 to 7r/2. 

Ac05 returns the arccosine of x, in the range 0 to tt. 

Atan returns the arctangent of x, in the range -7r/2 to 7r/2. 

Atan2 returns the arctangent of y/x, in the range -tt to tt, using the signs of both arguments to 
determine the quadrant of the return value. 

IMPORTANT NOTE: The corresponding single-precision routines fsin, fcos, ftan, fasin, facos, 
fatan, and fatan2 expect true single-precision arguments, and therefore cannot be called from 
standard C. They are provided for support of FORTRAN and Pascal. 

HARDWARE DEPENDENCIES 
Series 200/500: 

The approximate limit for the values passed to these functions is 2.98E8 for sin and cos, 
1.49E8 for tan, 1.29E4 for fsin and /cos, and 6.43E3 for ftan. 

The algorithms used for all functions except atan2 and fatan2 are from HP 9000 BASIC. 
DIAGNOSTICS 

Sin, cos, and tan lose accuracy when their argument is far from zero. For arguments sufficiently 
large, these functions return zero when there would otherwise be a complete loss of significance. 
In this case a message indicating TL08S error is printed on the standard error output, errno is 
set to ERANGE. 

If the magnitude of the argument of asin or acos is greater than one, or if both arguments of 
atan2 are zero, zero is returned and errno is set to EDOM. In addition, a message indicating 


float fsin (x) 
tfloat x; 

float fcos (x) 

Afloat x; 

float ftan (x) 

Ifloat x; 

float fasin (x) 

Afloat x; 

float facos (x) 

Jfloat x; 

float fatan (x) 

(float x; 

float fatan2 (y, x) 

(float y, x; 

( see important note below 
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DOMAIN error is printed on the standard error output.. 

Error handling is identical for both single- and double-precision routines, except for one con¬ 
sideration: In any situation where the double-precision routine would return ±HUGE, the 
corresponding single-precision routine returns ±MAXFLOAT. 

These error-handling procedures may be changed with the function matherr{3M). 

SEE ALSO 

matherr(3M). 
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NAME 

tsearch, tfind, tdelete, twalk - manage binary search trees 

SYNOPSIS 

^include <search.h> 

char *tsearch ((char *) key, (char **) rootp, compar) 
int (*compar)( ); 

char * tfind ((char *) key, (char **) rootp, compar) 
int (*compar)( ); 

char ♦tdelete ((char ♦) key, (char ♦♦) rootp, compar) 
int (♦compar) ( ); 

void twalk ((char ♦) root, action) 
void (♦action) ( ); 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Tsearch, tfind, tdelete, and twalk are routines for manipulating binary search trees. They are 
generalized from Knuth (6.2.2) Algorithms T and D. All comparisons are done with a user- 
supplied routine, compar. This routine is called with two arguments, the pointers to the elements 
being compared. It returns an integer less than, equal to, or greater than 0, according to whether 
the first argument is to be considered less than, equal to or greater than the second argument. 
The comparison function need not compare every byte, so arbitrary data may be contained in the 
elements in addition to the values being compared. 

Tsearch is used to build and access the tree. Key is a pointer to a datum to be accessed or 
stored. If there is a datum in the tree equal to *key (the value pointed to by key), a pointer to 
this found datum is returned. Otherwise, *key is inserted, and a pointer to it returned. Only 
pointers are copied, so the calling routine must store the data. Rootp points to a variable that 
points to the root of the tree. A NULL value for the variable pointed to by rootp denotes an 
empty tree; in this case, the variable will be set to point to the datum which will be at the root of 
the new tree. 

Like tsearch, tfind will search for a datum in the tree, returning a pointer to it if found. However, 
if it is not found, tfind will return a NULL pointer. The arguments for tfind are the same as for 
tsearch. 

Tdelete deletes a node from a binary search tree. The arguments are the same as for tsearch. 
The variable pointed to by rootp will be changed if the deleted node was the root of the tree. 
Tdelete returns a pointer to the parent of the deleted node, or a NULL pointer if the node is not 
found. 

Twalk traverses a binary search tree. Root is the root of the tree to be traversed. (Any node in 
a tree may be used as the root for a walk below that node.) Action is the name of a routine to be 
invoked at each node. This routine is, in turn, called with three arguments. The first argument is 
the address of the node being visited. The second argument is a value from an enumeration data 
type typedef enum { preorder, postorder, endorder, leaf } VISIT; (defined in the <search.h> 
header file), depending on whether this is the first, second or third time that the node has been 
visited (during a depth-first, left-to-right traversal of the tree), or whether the node is a leaf. 
The third argument is the level of the node in the tree, with the root being level zero. 

The pointers to the key and the root of the tree should be of type pointer-to-element, and cast to 
type pointer-to-character. Similarly, although declared as type pointer-to-character, the value 
returned should be cast into type pointer-to-element. 
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EXAMPLE 

The following code reads in strings and stores structures containing a pointer to each string and a 
count of its length. It then walks the tree, printing out the stored strings and their lengths in 
alphabetical order. 

#include <search.h> 

#include <stdio.h> 

struct node { /* pointers to these are stored in the tree */ 

char ^string; 
int length; 

}; 

char string_space[10000]; /* space to store strings */ 

struct node nodes[500]; /* nodes to store */ 

struct node *root = NULL; /♦ this points to the root */ 

main( ) 

{ 

char ♦strptr = string_space; 
struct node *nodeptr = nodes; 

void print_node( ), twalk( ); 

int i = 0, node_compare( ); 

while (gets(strptr) != NULL kk i++ < 500) { 

/* set node */ 

nodeptr—>string = strptr; 

nodeptr—>length = strlen(strptr); 

/* put node into the tree */ 

(void) tsearch((char *)nodeptr, &:root, 
node_compare); 

/* adjust pointers, so we don’t overwrite tree */ 

strptr += nodeptr—>length + 1; 

nodeptr++; 

} 

twalk(root, print_node); 

} 

/* 

This routine compares two nodes, based on an 
alphabetical ordering of the string field. 

*/ 

int 

node_compare(nodel, node2) 
struct node Hcnodel, ♦node2; 

{ 

return strcmp(nodel—>string, node2—>string); 

} 

/* 

This routine prints out a node, the first time 
twalk encounters it. 

*/ 
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void 

print__node(node, order, level) 
struct node **node; 

VISIT order; 
int level; 

{ 

if (order == preorder || order == leaf) { 

(void)printf( "string = %20s, length = %d\n", 

(*node)—>string, (*node)—>length); 

} 

} 

SEE ALSO 

bsearch(3C), hsearch(3C), lsearch(3C). 

DIAGNOSTICS 

A NULL pointer is returned by tsearch if there is not enough space available to create a new node. 
A NULL pointer is returned by tsearch, tfind and tdelete if rootp is NULL on entry. 

If the datum is found, both tsearch and tfind return a pointer to it. If not, tfind returns NULL, 
and tsearch returns a pointer to the inserted item. 

WARNINGS 

The root argument to twalk is one level of indirection less than the rootp arguments to tsearch 
and tdelete. 

There are two nomenclatures used to refer to the order in which tree nodes are visited. Tsearch 
uses preorder, postorder and endorder to respectively refer to visting a node before any of its chil¬ 
dren, after its left child and before its right, and after both its children. The alternate nomencla¬ 
ture uses preorder, inorder and postorder to refer to the same visits, which could result in some 
confusion over the meaning of postorder. 

BUGS 

If the calling function alters the pointer to the root, results are unpredictable. 
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NAME 

ttyname, isatty - find name of a terminal 
SYNOPSIS 

char *ttyname (fildes) 
int fildes; 

int isatty (fildes) 
int fildes; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Ttyname returns a pointer to a string containing the null-terminated path name of the terminal 
device associated with file descriptor fildes. 

Isatty returns 1 if fildes is associated with a terminal device, 0 otherwise. 

FILES 

/dev/*, /dev/*/* 

DIAGNOSTICS 

Ttyname returns a NULL pointer if fildes does not describe a terminal device in directory /dev. 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

ttyslot - find the slot in the utmp file of the current user 

SYNOPSIS 

int ttyslot ( ) 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Ttyslot returns the index of the current user’s entry in the /etc/utmp file. This is accomplished 
by actually scanning the file /etc/inittab for the name of the terminal associated with the stan¬ 
dard input, the standard output, or the error output (0, 1 or 2). 

FILES 

/etc/inittab 

/etc/utmp 

SEE ALSO 

getut(3C), ttyname(3C). 

DIAGNOSTICS 

A value of 0 is returned if an error was encountered while searching for the terminal name or if 
none of the above file descriptors is associated with a terminal device. 
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NAME 

ungetc - push character back into input stream 
SYNOPSIS 

^include <stdio.h> 

int ungetc (c, stream) 
int c; 

FILE ♦stream; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

Ungetc inserts the character c into the buffer associated with an input stream. That character, c, 
will be returned by the next getc(3S) call on that stream. Ungetc returns c, and leaves the file 
stream unchanged. 

One character of pushback is guaranteed, provided something has already been read from the 
stream and the stream is actually buffered. In the case that stream is stdin^ one character may be 
pushed back onto the buffer without a previous read statement. 

If c equals EOF, ungetc does nothing to the buffer and returns EOF. 

Fseek{3S) erases all memory of inserted characters. 

SEE ALSO 

fseek(3S), getc(3S), setbuf(3S). 

DIAGNOSTICS 

Ungetc returns EOF if it cannot insert the character. 
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NAME 

vprintf, vfprintf, vsprintf - print formatted output of a varargs argument list 
SYNOPSIS 

#include <stdio.h> 

#include <varargs.h> 

int vprintf (format, ap) 
char ^format; 
va_list ap; 

int vfprintf (stream, format, ap) 

FILE tstream; 
char ^format; 
va_list ap; 

int vsprintf (s, format, ap) 
char *s, ^format; 
va_list ap; 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

vprintf, vfprintf, and vsprintf are the same as printf, fprintf, and sprintf respectively, except that 
instead of being called with a variable number of arguments, they are called with an argument list 
as defined by varargs{h). 

EXAMPLE 

The following demonstrates how vfprintf could be used to write an error routine. 

^include <stdio.h> 

#include <varargs.h> 


/* 

* error should be called like 

* error(function__name, format, argl, arg2...); 

*/ 

/*VARARGS0*/ 

void 

error(va_alist) 

/* Note that the function_jname and format arguments cannot be 

* separately declared because of the definition of varargs. 

*/ 

va_dcl 

{ 

va, l ist args; 
char *fmt; 

va__start(args); 

/* print out name of function causing error */ 
(void)fprintf(stderr, "ERROR in %s: ", va_arg(args, char *)); 
fmt = va_arg(args, char *); 

/* print out remainder of message */ 

(void)vfprintf(stderr, fmt, args); 
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va_end(args); 
(void) abort ( ); 

} 

SEE ALSO 

printf(3S), varargs(5). 
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NAME 

intro - introduction to special files 
HP-UX COMPATIBILITY 

Remarks: In general, device drivers are not portable across systems; however, every effort has 
been made to make their behavior portable. Due to variation in hardware, this is not 
always possible. Programs which use these drivers directly are at higher than average 
risk of not being portable. 

DESCRIPTION 

This section describes various special files that refer to specific HP peripherals and device drivers. 
The names of the entries are usually derived from the type of device being described (disc, plotter, 
etc.), not the names of the special files themselves. Characteristics of both the hardware device 
and the corresponding HP-UX device driver are discussed where applicable. 

The devices are divided into two catagories, unblocked and blocked. An unblocked device is 
also called a ra’w or character-mode device. An unblocked device, such as a line printer, uses a 
character special file. 

Blocked devices, as the name implies, transfer data in blocks via the system’s normal buffering 
mechanism. Block devices use block special files. 

For specific details about the default special files shipped with your system, consult the System 
Administrator Manual for your system. 

The desired name is associated with a specific device when mknod{lM) is used to create a special 
file for that device. The following naming convention is recommended for use when creating spe¬ 
cial files (special file names are are independent of the hardware): 

[r] dev_id [prod—no] [model_initial] [sidli] [.] [digit] 

where: 

r if present, indicates that the device is treated as a raw device; 

otherwise, the file is a block-mode file. 

consists of one of the following mnemonics: 

ct CS/80 catridge tape drive 
hd hard disc 

mt 9-track tape drive 

fd flexible disc 

Ip line printer 

dig digitizer 

pit plotter or graphics CRT display 

HP product number for the device; 

the letter suffix (if any) associated with the device model 
number; 

s|d|i used with the HP 9895A to specify Single-sided, Double-sided, 

or IBM media format; 

.digit used when two or more identical devices are connected to the 

system; for example, if two HP 2631G printers are connected to 
the system, their special file names would be lp2631g and 
lp2631g.l (they could also be named Ip and Ip.l). 

HARDWARE DEPENDENCIES 
Series 500: 

Block special files cannot be opened for reading or writing. 

The IBM format capability in the HP 9895A is not officially supported on HP-UX. 


dev_id 


prod_no 

model-initial 
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NAME 

ct - cartridge tape access 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: HP 

DESCRIPTION 

This page describes the actions of the general HP-UX cartridge tape drivers when referring to a 
cartridge tape as either a block-mode or character-mode (raw) device. 

Cartridge tapes are designed for use as “streaming” devices, and are not designed to start and 
stop frequently. Like discs, they are technically “random access” devices, but such access is less 
efficient and causes more tape and drive wear than streaming mode. While it is possible to use a 
cartridge tape as a file system or random access storage device, such use will dramatically reduce 
the life expectancy of tape cartridges and the tape drive itself. 

Any CS/80 cartridge tape unit, whether built into a disc drive or operated as a standalone device, 
can be accessed as a blocked or raw device. 

Block special files access cartridge tapes through normal system buffering mechanisms. Buffering 
is handled such that concurrent accesses through multiple opens or mounts on the same physical 
device do not get out of phase. Block special files can be read and written without regard to phy¬ 
sical cartridge tape records. Each I/O operation results in one or more logical block transactions. 
Use of this mode is discouraged because it increases wear on tapes and drives. 

Character special files provide a raw interface for transferring data directly between the cartridge 
tape and the user’s read or write buffer. A single read or write operation always results in exactly 
one I/O transaction. This is considerably more efficient than block-mode I/O which can require 
several transactions to transfer the same amount of information and cannot handle the transfer 
directly between the drive and user space. 

Tcio[l) is provided on some systems so you can take advantage of the efficiencies of raw I/O, 
while also making optimal use of the streaming capabilities of the cartridge tape drives. During 
writes, buffers small transactions into larger data blocks that are optimal for cartridge tapes, and 
reverses the process during reads. It is particularly designed for use as a complement to cpio for 
handling backups. 

During raw I/O, there may be implementation-dependent restrictions on the alignment of the 
user buffer in memory and its maximum size. Also, each transfer must occur on a record boun¬ 
dary and must read a whole number of records. Record size is hardware dependent, but is usually 
1024 bytes. Use of tcio (1) hides all these issues. 

Each raw access is independent of other raw accesses and of block accesses to the same physical 
device. Thus, transfers are not guaranteed to occur in any particular order. Having multiple pro¬ 
grams access the cartridge tape is, in effect, random access, and is subject to the warnings above. 

In raw I/O, each operation is completed to the device before the call returns. For block-mode 
writes, data may be cached until it is convienient for the system to write it. In addition, block¬ 
mode reads potentially do a one (or more) block read-ahead. The interaction of block-mode and 
raw access to the same cartridge tape is not specified, and in general is unpredictable. Because 
block-mode writes can be delayed, it is possible for a program to generate requests much more 
rapidly than the drive can actually process them. Flushing a large number of requests could take 
several minutes, and during that time the system will not have use of the buffers taken by these 
requests, and thus will suffer a possibly severe performance degradation. If the tape drive and the 
system disc share a single controller, disc activity may be severely limited or stopped until the 
buffers are flushed. 

The name of a raw device (its character special file name) is typically the same as the name of the 
corresponding blocked device (its block special file name) prefixed with an "r". 
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HARDWARE DEPENDENCIES 
Series 500: 

Block-special devices cannot be opened for I/O. 

SEE ALSO 

mkdev(lM), mknod(lM), tcio(l), intro(4), disc(4), mt(4), and the HP-UX System Administrator 
Manual provided with your system. 
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NAME 

disc - direct disc access 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: HP 

DESCRIPTION 

This page describes the actions of the general HP-UX disc drivers when referring to a disc as 
either a blocked or unblocked (raw or character special) device. 

Block special files access discs via the system’s normal buffering mechanism. Buffering is done in 
such a way that concurrent access through multiple opens or mounts of the same physical device 
do not get out of phase. Block special files may be read and written without regard to physical 
disc records. Each I/O operation results in one or more logical block transactions. 

There is also a raw interface via a character special file which provides for direct transmission 
between the disc and the user’s read or write buffer. A single read or write operation results in 
exactly one transaction. Therefore raw I/O is considerably more efficient when many bytes are 
transmitted in a single operation because blocked disc access requires potentially several transac¬ 
tions and does not transmit directly to user space. 

In raw I/O, there may be implementation dependent restrictions on the alignment of the user 
buffer in memory. Also, each transfer must occur on a sector boundary and must read a whole 
number of sectors. The sector size is a hardware dependent value (1024 bytes is the generally 
preferred value). 

Each raw access is independent of other raw accesses and of block accesses to the same physical 
device. Thus, transfers are not guaranteed to occur in any particular order. 

In both raw and blocked I/O, each operation is completed to the device before the call returns. In 
addition, blocked I/O potentially does a one (or more) block read-ahead. 

The name of a raw device (its character special file name) is typically the same as the name of the 
corresponding blocked device (its block special file name) prefixed with an "r". 

SEE ALSO 

intro(4), mkdev(lM), mknod(lM), and the HP-UX System Administrator Manual included with 
your system. 

WARNING 

On some systems, having both a mounted file system and a block special file open on the same 
device is asking for trouble; this should be avoided if possible. This is because it may be possible 
for some files to have private buffers in some systems. 

Like discs, the cartridge tape units in command set 80 disc drives are also accessed as blocked or 
raw devices. However, using a cartridge tape as a file system will severely limit the life expec¬ 
tancy of the tape drive. Tapes should only be used for system back-up and other needs where 
data must be stored on tape, such as for transport or other uses. 
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NAME 

CRT graphics - information for CRT graphics devices 

HP-UX COMPATIBILITY 

Level: HP-UX/NON-STANDARD 

Origin: HP 

Remarks: This information is valid for Series 200 and 300 only. 

DESCRIPTION 

CRT graphics devices are frame-buffer based raster displays. These devices use memory mapped 
I/O to obtain much higher performance than is possible with tty-based graphics terminals. CRT 
graphics devices should only be accessed through the STARBASE libraries. They cannot be piped 
or redirected to because they are not serial devices. 

Special (device) files for CRT graphics devices are character special files with major number 12. 

The minor number for CRT graphics devices is of the form: 

OxSSTTXX 

where SS is a one-byte select code number, TT is a one-byte type specifier, and XX is an unused 
byte (should be zero). 

The type field in the minor number is defined as follows: 

0 auto-configures to one of the following: 

a) low resolution graphics device at physical address 0x520000 (if present). 

b) high resolution graphics device at physical address 0x560000 if low resolution 
device at 0x520000 not present. 

1 high resolution graphics device at physical address 0x560000 (unless there is no low 
resolution device at 0x520000, in which case type 1 is invalid). 

2 high or low resolution graphics device at the select code specified by the select code 
field in the minor number. 

Communication with a CRT graphics device is begun with an open system call. Multiple 
processes may concurrently have the graphics device open. 

Close shuts down the file descriptor associated with the graphics device. If the close is for the 
last system wide open on the device then the graphics device is also unmapped from the user 
address space; otherwise it is left mapped into the user address space (see GCUNMAP below). 

Read and write system calls are undefined and will always return ENXIO. 

loctl is used to control the graphics device. The valid ioctl commands (see <sys/graphics.h> ) 
are: 

GCID return the identity of the CRT graphics device. The possible identities are: 

1 = 98204A 

2 = 9826A 

3 = 9836A 

4 = 9836C 

5 = 98627A 

6 = 98204B 

7 = 9837 

8 = 98700 
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9 = hp9000s300 displays 
GOON, GCOFF 

turn graphics "on" or "off". May be a no-op for some devices. 

GCAON, GCAOFF 

turn alpha "on" or "off". May be a no-op for some devices. 

GCMAP map the CRT graphics device into the user address space at the address specified 
in the ioctl argument. The argument is ’char **arg’. The value *arg is used as a 
requested address. The actual mapping address is then returned in *arg. If *arg 
is 0 then the system selects the first available address (see GCLOCK/GCUNLOCK 
below). 

GCUNMAP remove the mapping of the CRT graphics device from the user address space. 
GCLOCK ensure exclusive use of the CRT graphics device. 

GCUNLOCK 

relinquish exclusive use of the CRT graphics device. 

For all frame buffers the data bytes scan from left to right and from top to bottom. Some 
displays map in control areas which must be skipped over to reach the frame buffer. Some devices 
map individual bits to pixels, (dots on the screen.) Some map bytes or parts of bytes to pixels. 
Lsb stands for least significant bit; msb stands for most significant bit. 

98204A and 9826A 

There are 300 lines of 100 bytes each. Only the odd numbered bytes are used. There 
is a one bit per pixel, with msb left, and lsb right. 

9836A and 98204B 

There are 390 lines of 64 bytes each. There is a one bit per pixel, with msb left, and 
lsb right. 

9836C Starting 0x800 bytes from the base address, there are 390 lines of 512 bytes each. All 
bytes are used. There is one byte per pixel. The bottom four bits of each byte are a 
color map index for that pixel. 

98627A Starting 0x8000 bytes from the base address, there are 3 buffers of 0x8000 bytes each. 

The 3 buffers are the data for red, green, and blue. There is one bit per pixel, with 
msb left, and lsb right. There are 64 bytes per line. The number of lines depends on 
the setting of control registers. 

9837 Starting 0x10000 bytes from the base address, there are 768 lines of 1024 bytes each. 
There is one pixel per byte. The lsb of each byte corresponds to a pixel. 

98700 Starting 0x10000 bytes from the base address, there are 768 lines of 1024 bytes each. 

There is one pixel per byte. Each byte corresponds to the color map index of a pixel. 
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Series 300 Displays: 

These displays have registers describing the display size. The following code computes 
frame buffer width and height and determines what portion of the frame buffer is 
being displayed. 

/* unsigned char *base = <base address for display mapping>; */ 
buffer_width = (base[5] << 8) + base[7]; 
buffer-height = (base[9] << 8) + base[ll]; 

displayed_^width = (base[13] << 8) + base[15]; 

displayed_height = (base[17] << 8) + base[19]; 

not—square = ((base[23] L 1) == 1); 

Starting 0x10000 bytes from the base address, there are <buffer—width> lines of 
<buffer—height> bytes each. There is one pixel per byte. Each byte corresponds to the color 
map index of a pixel. On a monochrome display, the byte value is either 0, (black), or 1 (white). 
If ((base[23] 1) == 1) then pixels are twice as high as they are wide, and may be used in pairs 

to produce square double pixels. 

One shared memory descriptor (see shmget(2)) is used for each graphics device. Each shared 
memory descriptor is accessible only through its graphics interface. Thus, any attempt to access 
them through shmat{2)), shmctl{2)), shmdt(2))^ etc. results in EACCESS errors. 

ERRORS 

[ENXIO] no such device or read/write not supported. 

[ENOSPC] cannot allocate required resources for mapping. 

[ENOMEM] cannot allocate sufficient memory for mapping. 

[ENOTTY] bad ioctl command, or an ioctl was attempted on an open file. 

SEE ALSO 

mknod(8). 
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NAME 

hpib - hpib interface information 

HP-UX COMPATIBILITY 

Level: HP-UX/NON-STANDARD 

Origin: HP 

DESCRIPTION 

HP-IB is Hewlett-Packard’s implementation of the Institute of Electrical and Electronic 
Engineers Standard Digital Interface for Programmable Instrumentation. For more information 
about the standard, consult any of the following documents: 

IEEE Std 488-1978 
lEC Pub 625-1 
ANSI MCl.l 

A read operation on a device connected to an HP-IB configures the computer as "listener" and 
the device as "talker". The read operation terminates when the number of bytes requested has 
been transferred, a pattern termination character is matched, or the device asserts the EOI (end 
or identify) line. A write operation configures the computer as "talker" and the device as 
"listener". The write operation terminates when the number of bytes specified has been 
transferred and it has asserted EOI. 

Devices connected to an HP-IB are addressed using three values. The first value, called the 
major value, is used to select the appropriate device driver. The second value is called the select 
code. The select code refers to the I/O interface card or slot number to which the device is con¬ 
nected. The third value is called the HP-IB address. The HP-IB address is usually set by an 
in-line or rotary switch on the device itself. Refer to the device reference manual for information 
on setting the HP-IB address. 

This driver is also used to access HP-IB plotters, digitizers and printers in raw mode. A printer 
in raw mode is used as a graphics device. 

The HP-IB address is in the range 0 through 30, unless you want to use the device-independent 
library (DIL) to talk to an I/O interface card on a raw bus (no automatic addressing). In this 
case, use HP-IB address 31. For more details on DIL, refer to the hpib*(SD), m*(3D), and 
gpio*{SD) manual entries. 

Terminating a write operation does not depend on an asserted EOI. 

HARDWARE DEPENDENCIES 
Series 200: 

The major value for HP-IB raw mode printers, plotters, and digitizers is always 21 (RAW 
HP-IB). 

Series 500: 

The major value for HP-IB printers, plotters, and digitizers is always 12 for HP 27110 
cards and 37 for the Model 550 internal HP-IB. 

SEE ALSO 

intro(4), mknod(lM), documentation for the specific device. 
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NAME 

iomap - physical address mapping 

HP-UX COMPATIBILITY 

Level: HP-UX/NON-STANDARD 

Origin: HP 

Remarks; This information is valid for Series 200 and 300 only. 

DESCRIPTION 

The iomap mechanism allows the mapping (thus direct access) of physical addresses into the user 
process address space. For Series 200/300 computers, the physical address space begins at 
0x000000 and extends to Oxffffff. 

The special (device) files for iomap devices are character special files with major number 10. 

The minor munber for iomap devices is of the form: 

OxAAAANN 

where AAAA is a two-byte address, and NN is a one-byte field. 

The address portion of the minor number is formed by dividing the physical address by 65536. 
NN*65536 is the size of the region to be mapped. For example, the minor number for a device at 
0x720000 and 128k in size is 0x007202. 

Access to the iomap devices is controlled by the file permissions set on the character special file. 

Multiple processes may concurrently have iomap devices opened and mapped. It is the responsi¬ 
bility of the processes to synchronize their accesses. 

Read and write system calls are not supported. 

loctl is used to control the iomap device. The valid ioctl commands (see <iomap.h> ) are: 
lOMAPMAP 

map the iomap device into the user address space at the address specified in the 
ioctl argument. If the argument is 0 then the system selects the first available 
address. Multiple processes may concurrently have the iomap device mapped. 

lOMAPUNMAP 

immap the iomap device from the user address space. 

Close shuts down the file descriptor associated with the iomap device. If the close is for the last 
system wide open on the device then the iomap device is also unmapped from the user address 
space; otherwise it is left mapped into the user address space (see lOMAPUNMAP above). 

One shared memory descriptor (see shmget{2)) is used for each iomap device. Shared memory 
descriptors are accessible only through the iomap interface. Consequently, attempts to access 
them through shmat(2), shmctl{2), shmdt(2), etc. result in EACCESS errors. 

WARNING 

Iomap devices should be created and used with extreme caution. Inappropriate accesses to io dev¬ 
ices or ram may result in a system crash. 

ERRORS 

[ENINVAL] address field out of range, ioctl command invalid. 

[ENOMEM] cannot allocate required memory for mapping. 

[ENODEV] read/write unsupported. 

[ENXIO] no such address. 
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[ENOSPC] cannot allocate required resources for mapping. 

[ENOTTY] bad ioctl command, or an ioctl was attempted on an open file. 

SEE ALSO 

mknod(8). 
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NAME 

Ip - line printer 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

All file names in /dev containing the mnemonic Ip are special files providing the interface to a 
particular line printer. A line printer is a character special device which may optionally have an 
interpretation applied to the data. 

If the Ip mnemonic is preceded by the character r, then data is sent to the printer in raw mode. 
(This could assume, for example, a graphic printer operation.) In raw mode, no interpretation is 
done on the data to be printed, and no page formatting is performed. The bytes are simply sent 
to the printer and printed as is. 

If the Ip mnemonic is not preceded by the character r, then the data is interpreted according to 
rules discussed below. The driver understands the concept of a printer page in that it has a page 
length (in lines), line length (in characters), and indent from the left margin (in characters). The 
default line length, indent, lines per page, open and close page eject, and handling of backspace 
are set to defaults determined when the printer is opened and recognized by the system the first 
time. If the printer is not recognized, the default line length is 132 characters, indent is 4 charac¬ 
ters, lines per page is 66, one page is ejected on close and none on open, and backspace is handled 
for a character printer. 

The following rules describe the interpretation of the data stream. 

A form feed causes a page eject and resets the line counter to zero. 

Multiple consecutive form-feeds are treated as a single form-feed. 

The new-line character is mapped into a carriage-return/line-feed sequence, and if an 
offset is specified a number of blanks are inserted after the carriage-return/line-feed 
sequence. 

A new-line that extends over the end of a page is turned into a form-feed. 

Tab characters are expanded into the appropriate number of blanks (tab stops are 
assumed to occur every eight character positions). 

Backspaces are interpreted to yield the appropriate overstrike either for a character 
printer or a line printer. 

Lines longer than the line length minus the indent (i.e., 128 characters, using the above 
defaults) are truncated. 

Carriage-return characters cause the line to be overstruck. 

Two ioctl{2) system calls are available to control the lines per page, characters per line, and 
indent. At either open or close time, if no page eject is requested, the paper will not be moved. 

^include <sys/lprio.h> 
ioctl (hides, command, arg) 
struct Iprio *arg; 

The commands are: 

LPRGET Get the current printer status information and store in the Iprio structure 
referenced by arg. 

LPRSET Set the current printer status information from the structure referenced by 

arg. 
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Thus, indent, page width and page length can be set with an external program. If the columns 
field is set to zero, the defaults are restored at the next open. 

FILES 

/dev/lp default or standard printer used by some HP-UX commands; 

/dev/[r] Ip* special files for printers 

HARDWARE DEPENDENCIES 
Series 500: 

The number of characters per line (80 or 132) and wrap-around can be selected/enabled 
via the minor number in the mknod(lM) command. See the System Administrator 
Manual for details. 

The LPRGET and LPRSET ioctl commands are not currently supported. 

Series 200: 

The uppercase-only fiag, the no-overprint flag, the raw-mode flag, and no-page-eject- 
on-open-or-close flag can be selected (enabled) by appropriate use of the minor number 
in the mknod{lM) command. See the HP-UX System Administrator Manual for details. 

Integral PC: 

This version of Ip is not supported on the Integral PC. Refer to the Integral Personal 
Computer Programmer’s Guide for more information about the Ip implementation on the 
Intregral PC. 

SEE ALSO 

lp(l), ioctl(2), intro(4). 
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NAME 

mem, kmem - core memory 

HP-UX COMPATIBILITY 

Level: HP-UX/Optional 

Origin: System III 

Remarks: Not all HP-UX systems provide the mem and kmem files. Programs which use them 
cannot expect to be portable from one HP-UX implementation to another. 

DESCRIPTION 

Mem is a special file that is an image of the core memory of the computer. It may be used, for 
example, to examine, and even to patch the system. 

Byte addresses in mem are interpreted as memory addresses. References to non-existent locations 
cause errors to be returned. 

Examining and patching device registers is likely to lead to unexpected results when read-only or 
write-only bits are present. 

The file kmem is the same as mem except that kernel virtual memory rather than physical 
memory is accessed. 

Mem and kmem should always be protected so that only the super-user can read and write them, 
othewise both privacy and system security are compromised. 

FILES 

/dev/mem, /dev/kmem 

HARDWARE DEPENDENCIES 
Series 500: 

Mem and kmem are not provided. 

Series 200: 

Memory does not begin at physical address 0. Instead, it occupies the upper portion of the 
physical address space from 0x900000 through Oxffffff, beginning at address Oxffffff and 
moving downward. Thus, if one megabyte of RAM is installed, it occupies addresses 
OxfOOOOO through OxfffPff. 

BUGS 

On some machines memory files are accessed one byte at a time, an inappropriate method for 
some device registers. 
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NAME 

modem - asynchronous serial modem line control 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 
DESCRIPTION 

This section describes the two modes of modem line control and the three types of terminal port 
access. It also discusses the effect of several bits of the termio structure which affect modem line 
control. The modem related ioctl(2) system calls are discussed at the end of the document. 

There are several terms that are used within the following discussion which will be defined here 
for reference. “Modem control lines” (CONTROL) are generally defined as those outgoing modem 
lines that are automatically controlled by the driver. “Modem status lines” (STATUS) are gen¬ 
erally defined as those incoming modem lines that are automatically monitored by the driver. 
CONTROL and STATUS for a terminal file vary according to the modem line control mode of the 
file (see Modem line control modes below). An open{2) to a port will be considered to be 
blocked if it is waiting for another file on the same port to be closed. An open to a port will be 
considered to be pending if it is waiting for the STATUS to be raised. An open to a port will be 
considered to be successful if the open system call has returned to the calling process without 
error. 

Open flag bits 

The only open flag bit recognized by the driver is the 0_NDELAY bit. When this bit is set, an 
open call to the driver will never become blocked. If possible, the open will be returned immedi¬ 
ately as successful, and the driver will continue the process of opening the tty file. If it is not pos¬ 
sible, then the open will be returned immediately with the appropriate error code as described in 
the appropriate section. 

Termio bits 

The CLOCAL bit in the termio structure (see termio{4) ) is used to remove the driver’s automatic 
monitoring of the modem lines. However, the user’s ability to control the modem lines is deter¬ 
mined only by the mode in effect and does not depend on the state of CLOCAL . Normally, the 
driver will monitor and require the STATUS to be raised. An open system call will raise the CON¬ 
TROL and wait for the STATUS before completing unless the CLOCAL bit is set. (If the 
0_NDELAY bit is set, the open will be returned immediately, but the driver will otherwise con¬ 
tinue to monitor the modem lines as normal based on the state of the CLOCAL bit.) If CLOCAL is 
set when the last close (2) is issued to the port, the driver will not attempt to break any modem 
connection which may exist unless the HUPCL bit is set (see below). Normally, loss of the 
STATUS will cause the driver to break the modem connection and lower the CONTROL ; however, 
if CLOCAL is set, any changes in the STATUS will be ignored. A connection is required before any 
data may be read or written, unless CLOCAL is set. Any timers that would normally be in effect 
(see Modem line control modes and Modem timers below) will be stopped while CLOCAL is 
set. 

When the CLOCAL bit is changed from clear to set, the driver will assume the existence' of an 
active device (such as a modem) on the port regardless of the STATUS . If any of the CONTROL 
are raised at that point in time, they will continue in that state. The STATUS will no longer be 
actively monitored. When the CLOCAL bit is changed from set to clear, the driver will resume 
actively monitoring the STATUS . If all of the CONTROL are raised at that point in time, the 
driver will attempt to begin or continue a modem connection. If any of the CONTROL are not 
raised, the driver will break the modem connection. If any of the STATUS are not raised, the 
driver will act as though those signals were lost as described in Modem line control modes 
below. If the device is a controlling terminal, a hangup signal will be sent to the process group. 
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The HUPCL bit in the termio structure determines the action of the driver regarding the CON¬ 
TROL when the last close system call is issued to a terminal file. If the HUPCL bit is set, the 
driver will lower the CONTROL at close time and the modem connection will be broken. If 
HUPCL is not set and a modem connection exists, it will continue to exist, even after the close is 
issued. 

Terminal port access types 

There are three types of modem access: call-in connections, call-out connections, and direct (no 
modem control) connections. A given port may be accessed through all three types of connection 
by accessing different files. The modem access type of a terminal file is determined by the file’s 
major and/or minor device numbers. 

The call-in type of access is used when the connection is expected to be established by an incom¬ 
ing call. This is the type that would be used by getty{lM) to accept logins over a modem. When 
an open is issued to such a file, the driver may wait for an incoming call and will then raise the 
CONTROL based on the current mode (see below) of the port. When the port is closed, the driver 
may lower the CONTROL depending on the HUPCL bit. 

The call-out type of access is used when the connection is expected to be established by an outgo¬ 
ing call. This would be used by programs such as uucp{l). When an open is issued to such a file, 
the driver will immediately raise the CONTROL and wait for a connection based on the mode 
currently in effect. When the port is closed, the driver may lower the CONTROL depending on 
the HUPCL bit. 

The direct type of access is used when no driver modem control is desired. This could then be 
used for directly connected terminals that use a three-wire connection, or to talk to a modem 
before a connection has been established. The second case allows a program to give dialing 
instructions to the modem. Neither the CLOCAL nor the HUPCL bits have any effect on a port 
accessed through a direct file. (However, both bits may be inherited by other types of files; see 
Terminal port access interlock below.) An open to a direct file does not affect the CONTROL 
and does not depend on any particular state of the STATUS to succeed. When the file is closed, 
the driver will not affect the state of the CONTROL . If a modem connection has been established, 
it will continue to exist. Setting the speed of a direct file to BO (see termio (4) ) will be considered 
an impossible speed change and will be ignored. It will not affect the CONTROL . 

Modem line control modes 

There are two modes of modem line control: CCITT mode and simple mode. A given port may 
have only one of these two modes in effect at any given point in time. An attempt to open a port 
with a mode other than the one in effect (from a pending or successful open on a different file) will 
cause the open to be returned with an ENXIO error. The modem access type of a terminal file is 
determined by the file’s major and/or minor device numbers. 

CCITT mode is used for connections to switched line modems. The CONTROL for CCITT mode 
are Data Terminal Ready (DTR) and Request to Send (RTS). The STATUS are Data Set Ready 
(DSR), Data Carrier Detect (DCD), and Clear to Send (CTS). Additionally, the Ring Indicate (RI) 
signal indicates the presence of an incoming call. When a connection is begun (an incoming call 
for a call-in file or an open issued to a call-out file), the CONTROL are raised and a connection 
timer (see Modem timers below) is started. If the STATUS become raised before the time period 
has elapsed, a connection is established and the open request is returned successfully. If the time 
period expires, the CONTROL are lowered and the connection is aborted. For a call-in file, the 
driver will wait for another incoming call; for a call-out file, the open will be returned with an EIO 
error. Once a connection is established, loss of either DSR or CTS will cause the CONTROL to be 
lowered and a hangup signal to be generated if the device is a controlling terminal. If DCD is lost, 
a timer is started. If DCD resumes before the time period has expired, the connection will be 
maintained. However, no data transfer will occur during this time. The driver will stop transmit¬ 
ting characters, and any characters received will be discarded. If DCD is not restored within the 
allotted time, the connection will be broken as described above for DSR and CTS . If the modem 
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connection is to be broken when the dose system call is issued (i.e. HUPCL is set), then the CON¬ 
TROL will be lowered and the close will be returned as successful. However, no further opens will 
be allowed until after both DSR and CTS have been lowered by the modem, and the hangup timer 
(see Modem timers below) has expired. The action taken in response to an open during this 
time will be the same as if the port were still open. (See Terminal port access interlock 
below.) 

When a port is in CCITT mode, the driver has complete control of the modem lines and the user 
is not allowed to change the setting of the CONTROL or affect which STATUS are actively moni¬ 
tored by the driver (see Modem ioctls below). This is to provide strict adherence with the 
CCITT recommendations. 

Simple mode is used for connections to devices which require only a simple method of modem line 
control. This can include devices such as black boxes, data switches, or for system-to-system con¬ 
nections. It can also be used with modems which can not operate under the CCITT recommenda¬ 
tions. The CONTROL for simple mode consists of only DTR . The STATUS consists of only DCD . 
When an open is issued, the CONTROL is raised but no connection timer is started. When the 
STATUS becomes raised, a connection is established and the open request is returned successfully. 
Once a connection is established, loss of the STATUS will cause the CONTROL to be lowered and a 
hangup signal to be generated if the device is a controlling terminal. 

When a port is in simple mode, the driver will normally control the modem lines. However, the 
user is allowed to change the setting of the CONTROL (see Modem ioctls below). 

Terminal port access interlock 

An interlock mechanism is provided between the three access types of terminal files. It prevents 
more than one file from being successfully opened at a time, but allows certain opens to succeed 
while others are pending so that a port can be opened through a call-out connection while getty 
has a pending open at a call-in connection. The three access types are given a priority that deter¬ 
mines which open will succeed if more than one file has an open issued against it. The three 
access types are ordered from lowest priority to highest as follows: call-in, call-out, and direct. 

If an open is issued to a port which already has a successful open on it of a lower priority type, 
the new open will be returned with an EBUSY error. (EBUSY will also be returned if a CCITT 
call-in file is not yet successful, but has received an incoming call indication.) If the lower priority 
open is pending, the new open will succeed if possible, or will be left pending if waiting for the 
STATUS . If a higher priority open has succeeded or is pending, the new open will be blocked, 
unless the new open has the 0_NDELAY flag bit set, in which case the open will be returned with 
an EBUSY error. Once an open on one type of file is successful, any pending opens on lower 
priority files will become blocked. 

When a file of one priority is closed, a blocked open on the next lower priority type file will 
become active. If all of the STATUS are raised, the open will succeed, otherwise the open will 
become pending waiting for the STATUS . If the lower priority open is successful (because the 
connection was maintained when the higher priority file was closed), the port characteristics 
(speed, parity, etc.) that were set by the higher priority file will be inherited by the lower priority 
file. If the connection is not maintained through the close, the port characteristics will be set to 
default values at the next successful open. 

Modem timers 

There are four timers currently defined for use with modem connections. The first three of the 
timers are applicable only to CCITT mode connections. In general, the effect of changing a timer 
value while the timer is running is system dependent. However, setting the timer value to zero is 
guaranteed to disable the timer even if it is running. 

The connect timer is used to limit the amount of time to wait for a connection to be established 
once it has been begun. This timer is started when an incoming call has been received on a call-in 
file, or when an open has been issued on a call-out file for which no opens are already pending. If 
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the connection is completed in time, the timer is aborted. If the time period expires, the connec¬ 
tion is aborted. For a call-in file, the driver will again wait for an incoming call and the open will 
remain pending. For a call-out file, the open will be returned with an EIO error. 

The carrier detect timer is used to limit the amount of time to wait before causing a disconnect if 
DCD drops. If carrier is not re-established in this time, a disconnect will occur. If carrier is re¬ 
established before the timeout, the timer will be aborted and the connection maintained. During 
the period when carrier is not raised, no data will be transferred across the line. 

The no activity timer is used to limit the amount of time a connection will remain open with no 
data transfer across the line. When the data line becomes quiescent with no data transfer, this 
timer will be started. If data is again transferred over the line in either direction before the time 
limit, the timer will be aborted. If no activity occurs before the timeout has occurred, the driver 
will disconnect the line. This can be used to avoid long and costly telephone connections when 
data transfer has been stopped either normally or abnormally. 

The last timer defined, the hangup timer, is used for both CCITT and simple modes. This timer 
controls the amount of time to wait after disconnecting a modem line before allowing another 
open to be allowed. This time period should be made long enough to guarantee that the connec¬ 
tion has been terminated by the telephone switching equipment. If this period is not long enough, 
the telephone connection may not be broken and a succeeding open may complete with the old 
connection. 

Modem ioctls 

Several ioctl system calls apply to manipulation of modem lines. They use the following informa¬ 
tion defined in <sys/modem.h>. 

#define NMTIMER 6 
typedef unsigned long mflag; 
struct mtimer { 

unsigned short m_timers [NMTIMER]; 

}; 

Individual modem lines are represented by bits in an unsigned long variable as follows: 

MRTS 00010000000 Request to Send outbound 
MCTS 00004000000 Clear to Send inbound 

MDSR 00002000000 Data Set Ready inbound 

MDCD 00000400000 Data Carrier Detect inbound 

MDTR 00000000040 Data Terminal Ready outbound 

MRI 00000000010 Ring Indicator inbound 

MDRS 00000000004 Data Rate Select outbound 

The timer values are defined in the array m_timers. The relative position of the timer and 

default initial values and units for each timer are as follows: 

0 MTCONNECT 25 s 

1 MTCARRIER 400 ms 

2 MTNOACTIVITY 0 min 

3 MTHANGUP 250 ms 

4 Reserved 

5 Reserved 

A value of zero for any timer will disable that timer. 

The modem line ioctl system calls have the form: 

ioctl (fildes, command, arg) 
unsigned long *arg; 
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The commands using this form are: 

MCGETA Get the current state of both inbound and outbound modem lines and store 
in the unsigned long referenced by arg. A raised line will be indicated by a 
one bit in the appropriate position. 

MCSETA Set the outbound modem lines from the unsigned long referenced by arg. 

Setting an outbound bit to one causes that line to be raised and zero to be 
lowered. Setting bits for inbound lines has no effect. Setting any bits while 
in CCITT mode has no effect. The change to the modem lines is immediate 
and using this form while characters are still being output may cause 
unpredictable results. 

MCSETAW Wait for the output to drain and set the new parameters as described 
above. 

MCSETAF Wait for the output to drain, then flush the input queue and set the new 
parameters as described above. 

The timer value ioctl system calls have the form: 

ioctl (hides, command, arg) 
struct mtimer *arg; 

The commands using this form are: 

MCGETT Get the current timer value settings and store in the mtimer structure refer¬ 
enced by arg. 

MCSETT Set the timer values from the structure referenced by arg. 

For any timer, setting the timer value to its previous value has no effect. 

FILES 

/dev/tty* 

/dev/ttyd* 

/dev/cul* 

/dev/cua* 

HARDWARE DEPENDENCIES 
Series 500: 

For the HP27140A 6-port modem multiplexer, the ranges and resolutions of the timers are 
as follows: 

MTCONNECT 0-255 sec, 1 sec resolution 
MTCARRIER 0-2550 msec, 10 msec resolution 
MTNOACTIVITY 0-1092 min, 1 min resolution 
MTHANGUP 0-65535 msec, 10 msec resolution 
If a timer is set out of its range, then the maximum value that timer can assume is used 
instead. 

For the HP27128A Asynchronous Serial Interface, the ioctl requests described above are 
not supported. The timers have hxed values as follows: 

MTCONNECT 25 sec 
MTCARRIER 400 msec 
MTNOACTIVITY 0 min 
MTHANGUP 500 msec 

This interface only supports the call-in and call-out port access types, and does not sup¬ 
port the direct access type. 

It is not possible to change the state of the CLOCAL bit when using CCITT mode. 
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Simultaneous call-in and call-out open atempts in CCITT mode are not allowed. 

The default state of the CLOCAL bit upon first open is determined by the state of switch 
on the interface (See the System Administrator Manual). 

SEE ALSO 

stty(l), mknod(lM), ioctl(2), termio(4). 

HP-UX System Administrator Manual 

WARNING 

It is occasionally possible that a process may open a call-out file at approximately the same time 
as an incoming call is received. In some cases, the call-out connection may be satisfied by the 
incoming call. In general, however, the results are indeterminate. If necessary, the situation can 
be avoided by the use of two modems and ports, one for call-out connections and the other for 
receiving incoming calls. 
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NAME 

magtape - magnetic tape interface and controls 
HP-UX COMPATIBILITY 

Level: Magnetic Tape Support — HP-UX/RUN ONLY 

Origin: UCB and HP 

DESCRIPTION 

The files /dev/mt* and /dev/rmt* refer to specific tape drives; the behavior of the specific unit 
is specified by several bits in the least significant digit of the minor number in the mknod{lM) 
command. 

There are three bits controlling the operation of the tape drive. These bits are usually encoded 
into the minor number of mknod{S). Refer to the System Administrator Manual for your com¬ 
puter for details. 

rewind When this bit is cleared, the tape is automatically rewound upon close. This is normally 
done for units numbered 0-3 and 8-11. 

mode When this bit is set, the tape drive behaves like the Berkeley tape drivers; when clear the 
driver behaves like System III. The details are described below. The ioctl operations 
described below work in both modes on raw tapes only. 

density When cleared, the tape drive is run at 1600 bpi; when set it is run at 800 bpi. The 800 
bpi drives are usually numbered 0-7, and 1600 bpi are usually numbered 8-15. 

When opened for reading or writing, the tape is assumed to be positioned as desired. 

When a file is opened for writing and then closed, a double end-of-file (double tape mark) is writ¬ 
ten. If the device has the rewind bit set, the tape is rewound; otherwise, the tape is positioned 
before the second EOF just written. 

When a read-only file is closed and the rewind bit is set, the tape is rewound. If the rewind bit is 
not set, the behavior depends on the mode bit. For System III compatibility, the tape is posi¬ 
tioned after the EOF following the data just read. For Berkeley compatibility, the tape is not re¬ 
positioned in any way. 

The EOF is returned as a zero-length read. 

By judiciously choosing mt files, it is possible to read and write multi-file tapes. 

A tape treated as a block device consists of several 512 byte records terminated by an EOF. To 
the extent possible, the system makes it possible to treat the tape like any other file. Seeks have 
their usual meaning and it is possible to read or write a byte at a time (although very inadvis¬ 
able). 

The mt files discussed above are useful when it is desired to access the tape in a way compatible 
with ordinary files. When foreign tapes are to be dealt with, and especially when long records are 
to be read or written, the raw interface is appropriate. The raw interface is described below. 

The special files associated with a raw tape interface are named rmt*. Each read or write call 
reads or writes the next record on the tape. In the write case the record has the same length as 
the buffer given. 

During a read, the record size is passed back as the number of bytes read, up to the buffer size 
specified. The number of bytes ignored is available in the mt—resid field of the mtget structure 
via the MTIOCGET call of ioctl. In raw tape I/O, the buffer and size may have implementation 
' dependent alignment restrictions. Seeks are ignored, instead the ioctl operations described below 
are available. An EOF is returned as a zero-length read, with the tape positioned after the EOF, 
so that the next read will return the next record. 

Using Ioctl With Magnetic Tape 

The ioctl system call can be used to manipulate magnetic tapes; refer to the include file 
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/usr/include/sys/mtio.h for a description of the possible operations. 

The following code fragment shows how an ioctl call might be used to perform several mag tape 
operations: 

^include <sys/types.h> 

#include <sys/mtio.h> 

#include <stdio.h> 
main(argc, argv) 
int argc; 
char *argv[]; 

{ 

int fd; 

struct mtop top; 

/* open mag tape device file */ 
top.mt—count = 1; 
switch(*argv[l]) { 

case 111: /* write an eof */ 

top.mt_op = MTWEOF; 
break; 

case /2/; /* rewind the tape */ 

top.mt_op = MTREW; 
break; 

case /3/: /* backspace record ♦/ 

top.mt_op = MTBSR; 
break; 

default: 

fprintf(stderr, "Unknown option: %s0, argv[l]); 

exit(l); 

break; 

} 

fd = ioctl(fd, MTIOCTOP, &;top); 

} 


This program accepts one argument which selects the operation to perform. The structure tem¬ 
plate mtop is defined in sys/mtio.h, and contains two parameters defining the operation to per¬ 
form [mt—op) and how many operations to perform {mt—count). All constants used above (plus 
many others not used) are defined in sys/mtio.h. 

HARDWARE DEPENDENCIES 

Series 200: 

Block magnetic tape is not supported. 


The density bit cannot select 800 bpi; 800 bpi is not supported. 

The settings of the mode, rewind, and density bits are refiected in the minor numbers 
used to create the special file names (see mkdev{S)). 

Series 500: 

Block magnetic tape is not supported. 

The density bit cannot select 800 bpi; 800 bpi is not supported. 

FILES 

/dev/mt* 

/dev/rmt* 
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SEE ALSO 

intro(4), mkdev(lM), mknod(lM), and the HP-UX System Administrator Manual included with 
your system. 
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NAME 

null - null file ("bit bucket") 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System III 

DESCRIPTION 

Data written on a null special file is discarded. 
Reads from a null special file always return 0 bytes. 

FILES 

/dev/null 
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NAME 

pty - pseudo terminal driver 

SYNOPSIS 

pseudo-device pty 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: Berkeley 4.2 

DESCRIPTION 

The pty driver provides a communication path between an HP-UX application process and a sup¬ 
porting server process, and behaves much like a terminal/computer communication path. It is 
structured so that output from either process acts as input to the other, thus the term 
psewdoterminal. The slave-side of pty interacts with the application process, and its behavior is 
defined by termio{4i). The master-side of pty interacts with the server process which controls the 
application process through pty as if pty were a hardware terminal interface. 

The following ioctl requests, defined in <sys/ptyio.h>, apply only to master side of pty: 
TIOCBREAK 

Causes a break operation to be done on the slave side of the pty. This action is the same 
as if a user had hit the break key on a real terminal. Takes no parameters. 

TIOCSIGSEND 

Causes a signal to be sent on the slave side of the pty to the current tty process group of 
the slave side. The value of the parameter is taken to be the signal number to be sent. 
An EINVAL error will be returned and no signal sent if the specified signal number does 
not refer to a legal signal (see signal(2)). Note that this request allows the server process 
to send signals to processes that are not owned by the same user id. 

TIOCSTOP 

Stops data flowing from the slave side of the pty to the master side (e.g. like typing "S). 
Takes no parameters. 

TIOCSTART 

Restarts output (stopped by TIOCSTOP or by typing "S). Takes no parameters. 
TIOCPKT 

Enable/disable packet mode. Packet mode is enabled by specifying (by reference) a 
nonzero int parameter and disabled by specifying (by reference) a zero int parameter. 
When applied to the master side of a pseudo terminal, each subsequent read from the 
master side will return data written on the slave part of the pseudo terminal preceded by 
a zero byte (symbolically defined as TIOCPKT__DATA), or a single byte reflecting con¬ 
trol status information. In the latter case, the byte is an inclusive-or of zero or more of 
the bits: 

TIOCPKT-FLUSHREAD 

whenever the read queue for the slave side is flushed. 

TIOCPKT-FLUSHWRITE 

whenever the write queue for the slave side is flushed. 

TIOCPKT_STOP 

whenever data flowing from the slave side of the pty to the master side is stopped 
by means of TIOCSTOP, or TCXONC. 

TIOCPKT_START 

whenever data flowing from the slave side of the pty to the master side is res¬ 
tarted. 
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TIOCPKT_DOSTOP 

whenever the stop and start characters get set to "S/"Q. 

TIOCPKT_NOSTOP 

whenever the stop and start characters get set to something other than "S/"Q. 

TIOCREMOTE 

A mode for the master half of a pseudo terminal, independent of TIOCPKT. This mode 
causes input to the pseudo terminal to be flow controlled and not input edited (regardless 
of the terminal mode). Each write to the master side produces a record boundary for the 
process reading the slave side. In normal usage, a write of data is like the data typed as a 
line on the terminal; a write of 0 bytes is like typing an end-of-flle character (the EOF 
character as deflned in termio(4)). The data read by the slave side is identical to the 
data written on the master side. Data written on the slave side and read on the master 
side with TIOCREMOTE enabled is still subject to the normal termio(4) processing. 
TIOCREMOTE can be used when doing remote line editing in a window manager, or 
whenever flow controlled input is required. The request takes one int sized parameter, 
passed by value. When zero, it disables TIOCREMOTE; when one it enables 
TIOCREMOTE. TIOCREMOTE is only effective when TIOCTTY (explained below) is 
also enabled, and all data buffered in the pseudo terminal will be flushed when this 
request is made. 

TIOCTTY 

Enable or disable all termio(4) processing by pty. When disabled, all data is passed 
through the pty with no modification. Termio(4) processing (of input and output such as 
tab expansion) is enabled by specifying (by reference) a nonzero int parameter and dis¬ 
abled by specifying (by reference) a zero int parameter. Default is to be enabled. When 
TIOCTTY is disabled, the following pty modes are also inoperable: TIOCBREAK, 
TIOCSTOP, TIOCSTART, TIOCPKT, TIOCREMOTE, and TIOCMONITOR. Issuing 
a TIOCTTY ioctl request will also flush all data buffered in the pseudo terminal, and 
release any processes currently blocked waiting for data. 

When TIOCTTY is enabled (the default case), all termio(4) ioctl requests are handled by 
the pty driver itself. When TIOCTTY is disabled, slave side termio(4) ioctl requests are 
either ignored completely or passed to the master side depending upon the state of TIOC- 
TRAP below. Slave side non-termio(4) ioctl requests are not affected by the state of 
TIOCTTY. They are always ignored completely or passed to the master side depending 
upon the state of TIOCTRAP below. 

Data being written through a pseudo terminal with TIOCTTY disabled will be handled in 
a manner similar to the way data flows through a pipe. A write request will block in the 
pty until all of its data has been written into the pty. A read request will block if there is 
no data available unless the 0_NDELAY flag is set (see fcntl(2)). When data is avail¬ 
able to be read, the read request will return whatever is available, and will not wait for 
the number of bytes requested to be satisfied. The number of bytes a pty can contain in 
its internal memory is implementation dependent, but will always be at least 256 bytes in 
each direction. For example, a write on the slave side of a pty of 1024 bytes might be 
read on the master side by four read requests returning 256 bytes each. The size of the 
chunks of data that are read is not guaranteed to be consistent, but no data will be lost. 

Opening and closing of the master side acts as a modem connection/disconnection on a real termi¬ 
nal as far as the slave side is concerned. Having no server on the master side will cause opens on 
the slave side to hang until there is a server. (termio(4) description of 0_NDELAY interaction 
with pty is also supported.) Opens to the master side are exclusive. Attempts to open an already 
open master side of a pty will return errno(2) error EBUSY. (Attempts to open a non-existent 
pty will return errno(2) ENXIO.) Closing the master side of a pty sends a SIGHUP hangup sig¬ 
nal to the tty process group number of the corresponding slave side and flushes pending input and 
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output. 

Any terniio(4) ioctl request can also be applied to the master side of the pty, unless TIOCTTY 
has been disabled. 

lOCTL/OPEN/CLOSE TRAPPING 

The capabilities that follow give additional flexibility and control for servers connected to the 
master side. 

When trapping of ioctl/open/close is enabled, ioctl(2), open(2), and close(2) requests made to the 
slave side will notify the server on the master side of each request. The close request will only 
notify the server and continue to completion, while the open and ioctl requests will not complete 
until the master side has had a chance to handle them. The master side acknowledges completion 
via an ioctl to the master side. If the pty is not enabled to pass ioctl(2), open(2), and close(2) 
from the slave to the master, then they will be ignored (except for termio(4) related processing). 

The following ioctl calls apply only to the master side of a pty and pertain to trapping open, close, 
and ioctl. They are also defined in <sys/ptyio.h>: 

TIOCTRAP 

Enable or disable trapping of ioctl, open, and close from the slave side. Trapping is 
enabled by specifying (by reference) a nonzero int parameter and disabled by specifying 
(by reference) a zero int parameter. Default is to be disabled. (termio(4) ioctl requests 
will not be trapped, unless TIOCTTY is also disabled or TIOCMONITOR is enabled.) 

TIOCTRAPSTATUS 

Find out if any ioctl/open/close traps are pending. The argument points to an int, that 
will be set to one if anything is pending and zero if nothing is pending. This ioctl request 
is used when the preferred method of a select(2) “exceptional condition” is not available. 

TIOCREQGET 

In response to a select(2) “exceptional condition” on the master side, this ioctl request 
will read the pending ioctl, open, or close information into memory pointed to by the 
argument in the form: 

struct request_info { 
int request; 
int argget; 
int argset; 
short pgrp; 
short pid; 

int errno_error; 

int return_rvalue; 

}; 

All elements of request_info refer to the slave side of the pty. Enumerating the elements: 

request is the ioctl command received. 

argget is the ioctl request to apply to master side to receive the trapped ioctl 

structure if there is one to receive, (a zero value means there is none). 
(When nonzero, argget is a TIOCARGGET request with the size field 
precomputed.) 

argset is the ioctl request to apply to master side to send back the resulting ioctl 

structure if there is one to send back, (a zero value means there is none). 
(When nonzero, argset is a TIOCARGSET request with the size field 
precomputed.) 
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Pgrp 


is the process group number of the process doing the operation. 


pid 

errno_error 

return_rvalue 


is the process id of the process doing the operation. 

is the errno(2) error code (initialized to zero) to be returned by ioctl on 
the slave side. 

(initialized to zero) is the success value to be returned by ioctl on the 
slave side when errno—error is not set. 


For the case that the ioctl argument received on the slave side is not a pointer, its value 
is stored as four bytes that can be retrieved with an ioctl request to the master side equal 
to argget. 

When an open or close is being passed, request will be set to TIOCOPEN or TIOC- 
CLOSE, respectively. For TIOCOPEN and TIOCCLOSE, both argget and argset will be 
of zero because there is no ioctl structure. When TIOCTTY is enabled, the termio(4) 
definition of open/close will be executed first, before being passed to the master side. 
Note, while all opens are trapped, only the last close on a particular inode for a pty slave 
side is trapped by the pty. 

If a TIOCREQGET is done before anything has been trapped, this master side ioctl will 
block until a slave side ioctl, open, or close is trapped. 

TIOCREQSET 

Done to complete the handshake started by a previous TIOCREQGET. The argument 
should point to the request_info structure as defined by the TIOCREQGET. 

Before doing this ioctl, to complete the handshake, the server should set errno—error to 
an errno(2) error value to be passed back to the slave side. If there is no error, 
errno—error can be left alone because the pty will have initialized it to zero. Also, when 
there is no error, return—value should be set, if other than a zero result is desired. It 
should be noted that the ability to determine the return value and error code for a 
request to the slave side is only available for trapped ioctl requests. The server will not 
be able to set these values if the trapped request is an open or a close. 

If the TIOCREQSET request is made and request in the passed request__info structure 
does not equal the trapped value, errno(2) EINVAL will be returned. (EINVAL is also 
returned if there is no trapped ioctl/open/close.) 

If the trapped slave-side request has been interrupted by a signal between the time that 
the server has done the TIOCREQGET and the TIOCREQSET, an EINVAL error will 
be returned by the TIOCREQSET request. 


TIOCMONITOR 

Enable or disable read only trapping of termio ioctl requests when TIOCTTY is also 
enabled. (When TIOCTTY is disabled, TIOCMONITOR has no effect. Also TIOC¬ 
MONITOR is independent of TIOCTRAP.) Trapping is enabled by specifying (by refer¬ 
ence) a nonzero int parameter and disabled by specifying (by reference) a zero int param¬ 
eter. Default is to be disabled. 


This allows a server process attached to the master side of the pty to know when charac¬ 
teristics of the line discipline in the pty are changed by an application on the slave side. 
The mechanism for handshaking trapped termio(4) requests (when TIOCTTY is enabled) 
is the same as that for non-termio(4) ioctl requests; except that any changes or error con¬ 
ditions set by the server on the master side will have no effect. (It is recommended that 
termio(4) ioctl requests be used on the master side to interrogate the configured state of 
the line discipline in the pty. One reason for this is to compensate for the window of time 
before TIOCMONITOR is enabled, when termio(4) ioctls were not trapped.) 

When using select{2) on the master side of a pty, the “exceptional condition” refers to an open, 

close, or ioctl pending on the slave side. Ready for reading or writing refers to a read, or write 
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pending respectively, from the point of view of the master side. 

Of the ioctls that are subject to being trapped, only one per pty may be handled at one time. 
This means that when an application does a non-termio(4) ioctl to the slave side, all other ioctls 
to the same pty slave side will be blocked until the first one is handshaked back by the master 
side. (Ioctls that are not trapped, such as termio(4) when TIOCTTY is enabled and TIOCMON- 
ITOR is disabled, will not be blocked.) This permits the implementation of indivisible operations 
by an ioctl call on the slave side that is passed to the server process. 

In summary, handshaking of an ioctl/open/close on the master side is done using the following 
steps: 

Slave Side open/close/ioctl Trapped. 

This is indicated via a select(2) exceptional condition or via the TIOC- 
TRAPSTATUS ioctl request. 

TIOCREQGET ioctl request. 

This is done to find out what slave open/close/ioctl is trapped. 
argget ioctl request. 

This optional ioctl is done if argget is nonzero and the server wants to do more 
than just reject the trapped slave ioctl. 

argset ioctl request. 

This optional ioctl is done if argset is nonzero and the server wants to pass back a 
modified ioctl structure. It is done after the trapped ioctl is processed via the 
server on the master side. 

TIOCREQSET ioctl request. 

This is done to complete the trapped slave open/close/ioctl. In case the trapped 
request is an ioctl, errno^error should be set appropriately, return—value should 
be set for trapped slave ioctls if errno—error is set to zero. 

While a process is waiting in the slave side of the pty for the server to complete a handshake, it is 
susceptible to receiving signals. The following master side ioctl allows the server process to con¬ 
trol how the pty will respond when a signal attempts to interrupt a trapped open or ioctl request. 

TIOCSIGMODE 

Sets the signal handling state of the pty to the mode specified as the argument. The 
mode can have three values, which are TIOCSIGBLOCK, TIOCSIGABORT, and TIOC- 
SIGNORMAL. 

TIOCSIGBLOCK 

Causes some signals that are destined for the process whose open/ioctl is trapped 
to be postponed. The signals that are blocked are those which would otherwise 
cause the process to jump to an installed signal handler. Signals that are 
currently being ignored or would cause the slave-side process to be aborted will 
not be held off. When the server process completes the handshake by means of 
the TIOCREQSET ioctl request, the slave-side process will return to the calling 
program, and any pending signals will then be acted upon. Any signals that the 
user has blocked by means of sigblock{2) will continue to be blocked. 

TIOCSIGABORT 

Forces all signals that interrupt a trapped open/ioctl request to not be restart- 
able. The server process will set this mode when it wants the interrupted 
requests to return to the calling program with an EINTR error. 

TIOCSIGNORMAL 

This is the default mode of the pty. If a signal interrupts a trapped open/ioctl 
request, the user’s signal handler routine has the option of specifying whether the 
request is to be restarted. If the request is to be restarted, it will be executed 
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again from the begining, and the server will have to do another TIOCREQGET 
to start the handshake over again. If the user’s signal handler routine specifies 
that the interrupted request is not to be restarted, then the request will return to 
the calling program with EINTR upon completion of the signal handler. Note 
that it is not guaranteed that the restarted request will be the very next one to 
be trapped. 

HARDWARE DEPENDENCIES 
Series 200: 

The largest ioctl argument passable between master and slave sides is currently 
limited to 128 bytes. 

Series 500: 

The largest ioctl argument passable between master and slave sides is currently 
limited to 128 bytes. 

The TIOCREMOTE mode is not currently implemented. 

FILES 

/dev/ptym/pty[pqrstuvw]* master pseudo terminals 

/dev/pty/tty[pqrstuvw]* slave pseudo terminals 

DIAGNOSTICS 

None. 


BUGS 

It is not possible for the slave side to indicate an end-of-fle condition to the master side. 

When using TIOCREMOTE, a single write to the master side of greater than 256 bytes may result 
in multiple smaller records being read from the slave side instead of only one record. 


SEE ALSO 

termio(4), ioctl(2), select(2), signal(2). 
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NAME 

stty - terminal interface for Version 6/PWB compatability 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD — Version 6 and PWB Compatability 

Origin: System V 

Remarks: These faclilities are included to aid in conversion of old programs, and should not be 
used in new code. Use the interface described in termio[^). Note that these conver¬ 
sions do not work for programs ported from Version 7 UNIX, since some Version 7 
flags are defined differently. 

DESCRIPTION 

These routines attempt to map the Version 6 and PWB stty and gtty calls into the current ioctls 
that perform the same functions. The mapping cannot be perfect. The way the features are 
translated is described below. The reader should be familiar with termio{A) before studying this 
page. 

The following data structure is defined in the include file sgtty.h: 
struct sgttyb { 


char 

sg_ispeed; 

/* input speed */ 

char 

sg_ospeed; 

/* output speed */ 

char 

sg_erase; 

/* erase character */ 

char 

sg_kill; 

/* kill character */ 

int 

} 

flags, as defined in 

#define 

sg_flags; 

/* mode flags */ 

sgtty.h, are: 

HUPCL 

01 

#define 

XTABS 

02 

#define 

LCASE 

04 

#define 

ECHO 

010 

#define 

CRMOD 

020 

#define 

RAW 

040 

#define 

ODDP 

0100 

#define 

EVENP 

0200 

#define 

ANYP 

0300 

#define 

NLDELAY 

001400 

#define 

TBDELAY 

002000 

#define 

CRDELAY 

030000 

#define 

VTDELAY 

040000 

#define 

BSDELAY 

0100000 

^define 

CRO 

0 

#define 

CRl 

010000 

#define 

CR2 

020000 

#define 

CR3 

030000 

#define 

NLO 

0 

#define 

NLl 

000400 

#define 

NL2 

001000 

#define 

NL3 

001400 

#define 

TABO 

0 

#define 

TABl 

002000 

#define 

NOAL 

004000 

#define 

FFO 

0 

#define 

FFl 

040000 
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#define BSO 0 

#define BSl 0100000 

When the stty{2) command {ioctl TIOCSETP) is executed, the flags in the old sgttyb structure 
are mapped into their new equivalents in the termio structure. Then the TCSETA command is 
executed. 

The following table shows the mapping between the old sgttyb flags and the current termio 
flags. Note that flags contained in the termio structure that are not mentioned below are 
cleared. 

HUPCL (if set) 

sets the termio HUPCL flag; 

HUPCL (if clear) 

clears the termio HUPCL flag; 

XTABS (if set) 

sets the termio TABS flag; 

XTABS (if clear) 

clears the termio TABS flag; 

TBDELAY (if set) 

sets the termio TABl flag; 

TBDELAY (if clear) 

clears the termio TABl flag; 

LCASE (if set) 

sets the termio lUCLC, OLCUC, and XCASE flags; 

LCASE (if clear) 

clears the termio lUCLC, OLCUC, and XCASE flags; 

ECHO (if set) 

sets the termio ECHO flag; 

ECHO (if clear) 

clears the termio ECHO flag; 

NOAL (if set) 

clears the termio ECHOK flag; 

NOAL (if clear) 

sets the termio ECHOK flag; 

CRMOD (if set) 

sets the termio ICRNL and ONLCR flags; also, if CRl is set, the termio CRl flag is set, 
and if CR2 is set, the termio ONOCR and CR2 flags are set; 

CRMOD (if clear) 

sets the termio ONLRET flag; also, if NLl is set, the termio CRl flag is set, and if NL2 is 
set, the termio CR2 flag is set; 

RAW (if set) 

sets the termio CSS flag, and clears the termio ICRNL and lUCLC flags; also, default 
values of 6 characters and 0.1 seconds are assigned to MIN and TIME, respectively; 

RAW (if clear) 

sets the termio BRKINT, IGNPAR, ISTRIP, IXON, IXANY, OPOST, CS7, PARENB, 
ICANON, and ISIG flags; also, the default values control-D and null are assigned to the 
control characters EOF and EOL, respectively; 

ODDP (if set) 

if EVENP is also set, clears the termio INPCK flag; otherwise, sets the termio PARODD 
flag; 

VTDELAY (if set) 

sets the termio FFDLY flag; 

VTDELAY (if clear) 

clears the termio FFDLY flag; 
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BSDELAY (if set) 

sets the termio BSDLY flag; 

BSDELAY (if clear) 

clears the termio BSDLY flag. 

In addition, the termio CREAD bit is set, and, if the baud rate is 110, the CSTOPB bit is set. 

When using TIOCSETP, the ispeed entry in the sgttyb structure is mapped into the appropri¬ 
ate speed in the termio GBAUD field. The erase and kill sgttyb entries are mapped into the 
termio erase and kill characters. 

When the gtty{2) {ioctl TIOCGETP) command is executed, the termio{4) TCGETA command 
is first executed. The resulting termio structure is then mapped into the sgttyb structure, 
which is then returned to the user. 

The following table shows how the termio flags are mapped into the old sgttyb structure. Note 
that all flags contained in the sgttyb structure that are not mentioned below are cleared. 

HUPCL (if set) 

sets the sgttyb HUPCL flag; 

HUPCL (if clear) 

clears the sgttyb HUPCL flag; 

ICANON (if set) 

clears the sgttyb RAW flag; 

ICANON (if clear) 

sets the sgttyb RAW flag; 

XCASE (if set) 

sets the sgttyb LCASE flag; 

XCASE (if clear) 

clears the sgttyb LCASE flag; 

ECHO (if set) 

sets the sgttyb ECHO flag; 

ECHO (if clear) 

clears the sgttyb ECHO flag; 

ECHOK (if set) 

clears the sgttyb NOAL flag; 

ECHOK (if clear) 

sets the sgttyb NOAL flag; 

PARODD (if set) 

sets the sgttyb ODDP flag; 

PARODD (if clear) 

clears the sgttyb ODDP flag; 

INPCK (if set) 

sets the sgttyb EVENP flag; 

PARODD, INPCK (if both clear) 

sets the sgttyb ODDP and EVENP flags; 

ONLCR (if set) 

sets the sgttyb CRMOD flag; also, if CRl is set, the sgttyb CRl flag is set, and if CR2 is 
set, the sgttyb CR2 flag is set; 

ONLCR (if clear) 

if CRl is set, the sgttyb NLl flag is set, and if CR2 is set, the sgttyb NL2 flag is set; 

TABS (if set) 

sets the sgttyb XTABS flag; 

TABS (if clear) 

clears the sgttyb XTABS flag; 

TABl (if set) 

sets the sgttyb TBDELAY flag; 
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TABl (if clear) 

clears the sgttyb TBDELAY flag; 

FFDLY (if set) 

sets the sgttyb VTDELAY flag; 

FFDLY (if clear) 

clears the sgttyb VTDELAY flag; 

BSDLY (if set) 

sets the sgttyb BSDELAY flag; 

BSDLY (if clear) 

clears the sgttyb BSDELAY flag. 

When using TIOCGETP, the termio GBAUD field is mapped into the ispeed and ospeed 
entries of the sgttyb structure. Also, the termio erase and kill characters are mapped into the 
erase and kill sgttyb entries. 

Note that, since there is not a one-to-one mapping between the sgttyb and termio structures, 
unexpected results may occur when using the older TIOCSETP and TIOCGETP calls. Thus, 
the TIOCSETP and TIOCGETP calls should be replaced in all future code by the current 
equivalents, TCSETA and TCGETA, respectively. 

SEE ALSO 

termio(4), stty(2). 
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NAME 

termio - general terminal interface 

HP-UX COMPATABILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

All of the asynchronous communications ports use the same general interface, no matter what 
hardware is involved. The remainder of this section discusses the common features of this inter¬ 
face. 

When a terminal file is opened, it normally causes the process to wait until a connection is esta¬ 
blished. In practice, users’ programs seldom open these files; they are opened by getty and become 
a user’s standard input, output, and error files. The very first terminal file opened by the process 
group leader of a terminal file not already associated with a process group becomes the control 
terminal for that process group. The control terminal plays a special role in handling quit and 
interrupt signals, as discussed below. The control terminal is inherited by a child process during a 
fork{2). A process can break this association by changing its process group using setpgrp{2). 

A terminal associated with one of these files ordinarily operates in full-duplex mode. Characters 
may be typed at any time, even while output is occurring, and are only lost when the system’s 
character input buffers become completely full, which is rare, or when the user has accumulated 
the maximum allowed number of input characters that have not yet been read by some program. 
This limit is dependent on the particular implementation, but is at least 256. When the input 
limit is reached, all the saved characters are thrown away without notice. 

Normally, terminal input is processed in units of lines. A line is delimited by a new-line (ASCII 
LF) character, an end-of-file (ASCII EOT) character, or an end-of-line character. This means that 
a program attempting to read will be suspended until an entire line has been typed. Also, no 
matter how many characters are requested in the read call, at most one line will be returned. It is 
not, however, necessary to read a whole line at once; any number of characters may be requested 
in a read, even one, without losing information. 

During input, erase and kill processing is normally done. By default, the character # erases the 
last character typed, except that it will not erase beyond the beginning of the line. By default, 
the character @ kills (deletes) the entire input line, and optionally outputs a new-line character. 
Both these characters operate on a key-stroke basis, independently of any backspacing or tabbing 
that may have been done. Both the erase and kill characters may be entered literally by preced¬ 
ing them with the escape character (\). In this case the escape character is not read. The erase 
and kill characters may be changed. 

Certain characters have special functions on input. These functions and their default character 
values are summarized as follows: 

INTR (Rubout or ASCII DEL) generates an interrupt signal which is sent to all processes with 
the associated control terminal. Normally, each such process is forced to terminate, but 
arrangements may be made either to ignore the signal or to receive a trap to an 
agreed-upon location; see signal(2). 

QUIT (Control-1 or ASCII FS) generates a quit signal. Its treatment is identical to the inter¬ 

rupt signal except that, unless a receiving process has made other arrangements, it will 
not only be terminated but a core image file (called core) will be created in the current 
working directory if the implementation supports core files. 

ERASE (#) erases the preceding character. It will not erase beyond the start of a line, as del¬ 
imited by a NL, EOF, or EOL character. 

KILL (@) deletes the entire line, as delimited by a NL, EOF, or EOL character. 
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EOF (Control-d or ASCII EOT) may be used to generate an end-of-file from a terminal. 

When received, all the characters waiting to be read are immediately passed to the pro¬ 
gram, without waiting for a new-line, and the EOF is discarded. Thus, if there are no 
characters waiting, which is to say the EOF occurred at the beginning of a line, zero 
characters will be passed back, which is the standard end-of-file indication. 

NL (ASCII LF) is the normal line delimiter. It can not be changed or escaped. 

EOL (ASCII NUL) is an additional line delimiter, like NL. It is not normally used. 

STOP (Control-s or ASCII DCS) can be used to temporarily suspend output. It is useful with 

CRT terminals to prevent output from disappearing before it can be read. While output 
is suspended, STOP characters are ignored and not read. 

START (Control-q or ASCII DCl) is used to resume output which has been suspended by a 
STOP character. While output is not suspended, START characters are ignored and not 
read. The start/stop characters can not be changed or escaped. 

The character values for INTR, QUIT, ERASE, KILL, EOF, and EOL may be changed to suit indivi¬ 
dual tastes. The ERASE, KILL, and EOF characters may be escaped by a preceding \ character, in 
which case no special function is done. 

When a modem disconnect is detected, a hang-up signal is sent to all processes that have this ter¬ 
minal as the control terminal. Unless other arrangements have been made, this signal causes the 
processes to terminate. If the hang-up signal is ignored, any subsequent read returns with an 
end-of-file indication. Thus, programs that read a terminal and test for end-of-file can terminate 
appropriately when hung up on. 

When one or more characters are written, they are transmitted to the terminal as soon as 
previously-written characters have finished typing. Input characters are echoed by putting them 
in the output queue as they arrive. If a process produces characters more rapidly than they can 
be typed, it will be suspended when its output queue exceeds some limit. When the queue has 
drained down to some threshold, the program is resumed. 

Several ioctl{2) system calls apply to terminal files. The primary calls use the following structure, 
defined in <termio.h>: 

#define NCC 8 
struct termio { 

unsigned short c_Jflag; /* input modes */ 

unsigned short c_oflag; /* output modes */ 

unsigned short c_cflag; /* control modes */ 

unsigned short c__lflag; /* local modes */ 

char c_line; /* line discipline */ 

unsigned char c_cc[NCC]; /* control chars */ 

}; 

The special control characters are defined by the array c_cc. The relative positions and initial 
values for each function are as follows: 

0 VINTR DEL 

1 VQUIT FS 

2 VERASE # 

3 VKILL @ 

4 VEOF EOT 

5 VEOL NUL 

6 reserved 

7 reserved 

The c^iflag field describes the basic terminal input control: 
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IGNBRK 

0000001 

BRKINT 

0000002 

IGNPAR 

0000004 

PARMRK 

0000010 

INPCK 

0000020 

ISTRIP 

0000040 

INLCR 

0000100 

IGNCR 

0000200 

ICRNL 

0000400 

lUCLC 

0001000 

IXON 

0002000 

IXANY 

0004000 

IXOFF 

0010000 

lENQAK 

0020000 


Ignore break condition. 

Signal interrupt on break. 

Ignore characters with parity errors. 
Mark parity errors. 

Enable input parity check. 

Strip character. 

Map NL to CR on input. 

Ignore CR. 

Map CR to NL on input. 

Map upper-case to lower-case on input. 
Enable start/stop output control. 
Enable any character to restart output. 
Enable start/stop input control. 

Enable output pacing control. 


If IGNBRK is set, the break condition (a character framing error with data all zeros) is ignored, 
that is, not put on the input queue and therefore not read by any process. Otherwise if BRKINT 
is set, the break condition will generate an interrupt signal and flush both the input and output 
queues. If IGNPAR is set, characters with other framing and parity errors are ignored. 


If PARMRK is set, a character with a framing or parity error which is not ignored is read as the 
three-character sequence; 0377, 0, X, where X is the data of the character received in error. To 
avoid ambiguity in this case, if ISTRIP is not set, a valid character of 0377 is read as 0377, 0377. 
If PARMRK is not set, a framing or parity error which is not ignored is read as the character NUL 
( 0 ). 

If INPCK is set, input parity checking is enabled. If INPCK is not set, input parity checking is dis¬ 
abled. This allows output parity generation without input parity errors. 

If ISTRIP is set, valid input characters are first stripped to 7-bits, otherwise all 8-bits are pro¬ 
cessed. 


If INLCR is set, a received NL character is translated into a CR character. If IGNCR is set, a 
received CR character is ignored (not read). Otherwise if ICRNL is set, a received CR character is 
translated into a NL character. 


If lUCLC is set, a received upper-case alphabetic character is translated into the corresponding 
lower-case character. 


If IXON is set, start/stop output control is enabled. A received STOP character will suspend out¬ 
put and a received START character will restart output. All start/stop characters are ignored and 
not read. If IXANY is set, any input character, will restart output which has been suspended. 

If IXOFF is set, the system will transmit START/STOP characters when the input queue is nearly 
empty/full. 

If lENQAK is set, the system will transmit ASCII ENQ after every 80 characters sent and then wait 
until the terminal responds with ASCII ACK. The terminal will respond in this way when it has 
sufficiently emptied its buffer. If the terminal does not respond after 5 seconds, the system will 
resume transmission anyway. The ASCII ACK that the terminal sends will not get entered into 
the input queue if it was sent in response to ASCII ENQ. 

The initial input control value is all-bits-clear. 

The c—oflag field specifies the system treatment of output: 


OPOST 

0000001 

OLCUC 

0000002 

ONLCR 

0000004 

OCRNL 

0000010 

ONOCR 

0000020 


Postprocess output. 

Map lower case to upper on output. 
Map NL to CR-NL on output. 

Map CR to NL on output. 

No CR output at column 0. 
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ONLRET 

0000040 

NL performs CR function. 

OFILL 

0000100 

Use fill characters for delay. 

OFDEL 

0000200 

Fill is DEL, else NUL. 

NLDLY 

0000400 

Select new-line delays: 

NLO 

0 


NLl 

0000400 


CRDLY 

0003000 

Select carriage-return delays: 

CRO 

0 


CRl 

0001000 


CR2 

0002000 


CR3 

0003000 


TABDLY 

0014000 

Select horizontal-tab delays: 

TABO 

0 


TABl 

0004000 


TAB2 

0010000 


TAB3 

0014000 

Expand tabs to spaces. 

BSDLY 

0020000 

Select backspace delays: 

BSO 

0 


BSl 

0020000 


VTDLY 

0040000 

Select vertical-tab delays: 

VTO 

0 


VTl 

0040000 


FFDLY 

0100000 

Select form-feed delays: 

FFO 

0 


FFl 

0100000 



If OPOST is set, output characters are post-processed as indicated by the remaining flags, other¬ 
wise characters are transmitted without change. 

If OLCUC is set, a lower-case alphabetic character is transmitted as the corresponding upper-case 
character. This function is often used in conjunction with lUCLC. 

If ONLCR is set, the NL character is transmitted as the CR-NL character pair. If OCRNL is set, 
the CR character is transmitted as the NL character. If ONOCR is set, no CR character is 
transmitted when at column 0 (first position). If ONLRET is set, the NL character is assumed to 
do the carriage-return function; the column pointer will be set to 0 and the delays specified for CR 
will be used. Otherwise the NL character is assumed to do just the line-feed function; the column 
pointer will remain unchanged. The column pointer is also set to 0 if the CR character is actually 
transmitted. 

The delay bits specify how long transmission stops to allow for mechanical or other movement 
when certain characters are sent to the terminal. In all cases a value of 0 indicates no delay. If 
OFILL is set, fill characters will be transmitted for delay instead of a timed delay. This is useful 
for high baud rate terminals which need only a minimal delay. If OFDEL is set, the fill character 
is DEL, otherwise NUL. 

If a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is set, the carriage-return delays are used 
instead of the new-line delays. If OFILL is set, two fill characters will be transmitted. 

Carriage-return delay type 1 is dependent on the current column position, type 2 is about 0.10 
seconds, and type 3 is about 0.15 seconds. If OFILL is set, delay type 1 transmits two fill charac¬ 
ters, and type 2, four fill characters. 

Horizontal-tab delay type 1 is dependent on the current column position. Type 2 is about 0.10 
seconds. Type 3 specifies that tabs are to be expanded into spaces. If OFILL is set, two fill char¬ 
acters will be transmitted for any delay. 
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Backspace delay lasts about 0.05 seconds. If OFILL is set, one fill character will be transmitted. 
The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 

The c—cflag field describes the hardware control of the terminal: 


GBAUD 

0000037 

Baud rate: 

BO 

0 

Hang up 

B50 

0000001 

50 baud 

B75 

0000002 

75 baud 

BllO 

0000003 

110 baud 

B134 

0000004 

134.5 baud 

B150 

0000005 

150 baud 

B200 

0000006 

200 baud 

B300 

0000007 

300 baud 

B600 

0000010 

600 baud 

B900 

0000011 

900 baud 

B1200 

0000012 

1200 baud 

B1800 

0000013 

1800 baud 

B2400 

0000014 

2400 baud 

B3600 

0000015 

3600 baud 

B4800 

0000016 

4800 baud 

B7200 

0000017 

7200 baud 

B9600 

0000020 

9600 baud 

B19200 

0000021 

19200 baud 

B38400 

0000022 

38400 baud 

EXTA 

0000036 

External A 

EXTB 

0000037 

External B 

GSIZE 

0000140 

Character size: 

CS5 

0 

5 bits 

CS6 

0000040 

6 bits 

CS7 

0000100 

7 bits 

CS8 

0000140 

8 bits 

GSTOPB 

0000200 

Send two stop bits, else one. 

GREAD 

0000400 

Enable receiver. 

PARENB 

0001000 

Parity enable. 

PARODD 

0002000 

Odd parity, else even. 

HUPGL 

0004000 

Hang up on last close. 

GLOGAL 

0010000 

Local line, else dial-up. 


The GBAUD bits specify the baud rate. The zero baud rate, BO, is used to hang up the connec¬ 
tion. If BO is specified, the modem control lines (see modem(4) ) will cease to be asserted. Nor¬ 
mally, this will disconnect the line. For any particular hardware, impossible speed changes are 
ignored. 

The CSIZE bits specify the character size in bits for both transmission and reception. This size 
does not include the parity bit, if any. If CSTOPB is set, two stop bits are used, otherwise one 
stop bit. For example, at 110 baud, two stops bits are required. 

If PARENB is set, parity generation and detection is enabled and a parity bit is added to each 
character. If parity is enabled, the PARODD flag specifies odd parity if set, otherwise even parity 
is used. 

If CREAD is set, the receiver is enabled. Otherwise no characters will be received. 

The specific effects of the HUPCL and CLOCAL bits depend on the mode and type of the modem 
control in effect. See modem(4) for the details. 
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If HUPCL is set, the modem control lines for the port will be disconnected when the last process 
with the port open closes it or terminates. 

If CLOCAL is set, a connection does not depend on the state of the modem status lines. 

Under normal circumstances, an open will wait for the type of modem connection requested to 
complete. However, if the 0_NDELAY bit is specified (see open{2) ) or the CLOCAL bit has been 
set, the open will return immediately without waiting for the connection. For those files on which 
the connection has not been established or has been lost, and for which the CLOCAL bit is not set, 
both read and write will return a zero character count. For read, this is equivalent to an end-of- 
file condition. 


The initial hardware control value after open is B300, CSS, CREAD, HUPCL. 


The C—lflag field of the argument structure is used by the line discipline to control terminal func¬ 
tions. The basic line discipline (0) provides the following: 


ISIG 

0000001 

ICANON 

0000002 

XCASE 

0000004 

ECHO 

0000010 

ECHOE 

0000020 

ECHOK 

0000040 

ECHONL 

0000100 

NOFLSH 

0000200 


Enable signals. 

Canonical input (erase and kill processing). 
Canonical upper/lower presentation. 
Enable echo. 

Echo erase character as BS-SP-BS. 

Echo NL after kill character. 

Echo NL. 

Disable flush after interrupt or quit. 


If ISIG is set, each input character is checked against the special control characters INTR and 
QUIT. If an input character matches one of these control characters, the function associated with 
that character is performed. If ISIG is not set, no checking is done. Thus these special input func¬ 
tions are possible only if ISIG is set. These functions may be disabled individually by changing 
the value of the control character to an unlikely or impossible value (e.g., 0377). 


If ICANON is set, canonical processing is enabled. This enables the erase and kill edit functions, 
and the assembly of input characters into lines delimited by NL, EOF, and EOL. If ICANON is not 
set, read requests are satisfied directly from the input queue. A read will not be satisfied until at 
least MIN characters have been received or the timeout value TIME has expired between charac¬ 
ters. This allows fast bursts of input to be read efficiently while still allowing single character 
input. The MIN and TIME values are stored in the position for the EOF and EOL characters, 
respectively. The time value represents tenths of seconds. 


If XCASE is set, and if ICANON is set, an upper-case letter is accepted on input by preceding it 
with a \ character, and is output preceded by a \ character. In this mode, the following escape 
sequences are generated on output and accepted on input: 


for: 


{ 

} 

\ 


\' 

\! 

\‘ 

\( 

\) 

W 


For example, A is input as \a, \n as \\n, and \N as \\\n. 
If ECHO is set, characters are echoed as received. 


When ICANON is set, the following echo functions are possible. If ECHO and ECHOE are set, the 
erase character is echoed as ASCII BS SP BS, which will clear the last character from a CRT screen. 
If ECHOE is set and ECHO is not set, the erase character is echoed as ASCII SP BS. If ECHOK is 
set, the NL character will be echoed after the kill character to emphasize that the line will be 
deleted. Note that an escape character preceding the erase or kill character removes any special 
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function. If ECHONL is set, the NL character will be echoed even if ECHO is not set. This is use¬ 
ful for terminals set to local echo (so-called half duplex). Unless escaped, the EOF character is not 
echoed. Because EOT is the default EOF character, this prevents terminals that respond to EOT 
from hanging up. 

If NOFLSH is set, the normal flush of the input and output queues associated with the quit and 
interrupt characters will not be done. 

The initial line-discipline control value is all bits clear. 

The primary ioctl{2) system calls have the form: 

ioctl (Aides, command, arg) 
struct termio *arg; 

The commands using this form are: 

TCGETA Get the parameters associated with the terminal and store in the termio 
structure referenced by arg. 

TCSETA Set the parameters associated with the terminal from the structure refer¬ 
enced by arg. The change is immediate. 

TCSETAW Wait for the output to drain before setting the new parameters. This form 

should be used when changing parameters that will affect output. 

TCSETAF Wait for the output to drain, then flush the input queue and set the new 
parameters. 

Additional ioctl[2) calls have the form: 

ioctl (Aides, command, arg) 
int arg; 

The commands using this form are: 

TCSBRK Wait for the output to drain. If arg is 0, then send a break (zero bits for at 
least 0.25 seconds). 

TCXONC Start/stop control. If arg is 0, suspend output; if 1, restart suspended out¬ 
put. 

TCFLSH If arg is 0, flush the input queue; if 1, flush the output queue; if 2, flush 
both the input and output queues. 

HARDWARE DEPENDENCIES 
Series 200/300: 

Data loss may occur with HP 98626/98644 serial interfaces if the effective combined data 
rate for all installed serial interfaces exceeds 2400 baud (for example, two interfaces run¬ 
ning at 1200 baud and a third at 300 baud is equivalent to 2700 baud combined). 

The c—iflag field parameter IXANY (enable any character to restart output) is not sup¬ 
ported by the HP 98628B interface card. 

The c—iflag field parameter lENQAK (enable output pacing control) is not supported. 
Timed delays are not supported. 

The HP 98628B interface does not support the following baud rates: 900, 7200, 38 400. 

The c—lflag field parameter XCASE is not supported. 

Series 500: 

38400 baud is not supported by the RS-232 interface. 
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European modems are not currently supported. 

HP27140 Six-Channel Modem Multiplexer: 

Timed output delays (as opposed to fill-character delays) are not supported. 

The XCASE flag is not supported. 

These baud rates are not supported: 200, 38400, EXTA, and EXTB. 

HP27128 Asynchronous Serial Interface, HP27130 Eight-Channel Multiplexer: 

These baud rates are not supported: 200, 38400, EXTA, and EXTB. 

There is no support for tab expansion, case mapping, or output delays for control 
characters. 

The line kill character is always echoes as <backslash><CR><LF>, so the 
ECHOK flag is not setable, and will always have the same state as the ECHO flag. 

When type-ahead limit is reached, input is not flushed, but further input is sim¬ 
ply ignored. 

The PARMRK flag is not supported. 

The echoing of carriage-return and new-line characters may not be quite as 
expected in the more obscure driver configurations. 

The echoing of the EOF character is not suppressed. 

The ONLRET, ONOCR, and OCRNL flags are not supported. 

The VMIN and VTIME parameters for raw terminal input are not supported. 

The ECHONL flag is not supported. 

When ECHOE is set and ECHO is clear, a <SP><BS> is not echoes for the erase 
character. 

(27130 only) The CLOCAL flag is permanently set. 

(27128 only) The default setting of baud rate, bits per character, parity, and 
CLOCAL bit are determined by the switches on the interface. 

(27128 only) The "direct connect" cable (female connector) does not contain a 
Data Carrier Detect line, so a hangup signal will be sent if the CLOCAL flag is 
cleared when this cable is being used. 

Model 520 Console, HP98700 Terminal, Pseudo Terminal (pty): 

Since these devices do not deal with real asynchronous serial data links, the fol¬ 
lowing flags are meaningless: IGNPAR, PARMRK, INPCK, IXOFF, lENQAK, 
CBAUD, CSIZE, CSTOPB, PARENB, PARODD, HUPCL, and CLOCAL. 

FILES 

/dev/tty* 

/dev/console 

SEE ALSO 

stty(l), fork(2), ioctl(2), stty(2), setpgrp(2), signal(2), tty(4), modem(4), mknod(8). 


HARDWARE DEPENDENCIES 
Series 200/300: 

Data loss may occur with the 98626/98644 if the effective input of all 98626/98644 cards I 
exceeds 2400 baud. 

The c—iflag field parameter IXANY (enable any character to restart output) is not sup¬ 
ported by the HP 98628B interface card. 
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The c—iflag field parameter lENQAK (enable output pacing control) is not supported. 
Timed delays are not supported. 

The HP 98628B interface does not support the following baud rates: 900, 7200, 38400. 
The c—lflag field parameter XCASE is not supported. 
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NAME 

tty - controlling terminal interface 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

DESCRIPTION 

The file /dev/tty is, in each process, a synonym for the control terminal associated with the pro¬ 
cess group of that process, if any. It is useful for programs or shell sequences that wish to be sure 
of writing messages on the terminal no matter how output has been redirected. It can also be 
used for programs that demand the name of a file for output, when typed output is desired and it 
is tiresome to find out what terminal is currently in use. 

FILES 

/dev/tty 

/dev/tty* 

SEE ALSO 

termio(4). 
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NAME 

intro - introduction to file formats 
HP-UX COMPATIBILITY 

Remarks: Header files are often used to hide hardware incompatibilities. 

DESCRIPTION 

This section outlines the formats of various files. The C struct declarations for the file formats 
are given where applicable. Usually, these structures can be found in the directories 
/usr/include or /usr/include/sys. 
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NAME 

a.out - assembler and link editor output 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System III 

Remarks: This manual page describes the a.out file format for Series 200 and 300 computers. 
Refer to other a. out[5i) manual pages for descriptions of other valid implementations. 

DESCRIPTION 

A.out is the output file of the link editor Id. Ld will make a.out executable if there were no link¬ 
ing errors and no unresolved external references. The assembler as produces non-executable files 
with the same structure. 

File a.out has seven sections: a header, the program text and data segments, a pascal interface 
section, a symbol table, information for debugger support, and text and data relocation informa¬ 
tion (in that order). The pascal interface text will only be present in those pascal code segments 
that have not been linked. The last three sections may be missing if the program was linked with 
the -s option of ld(l) or if the symbol table, debug information, and relocation bits were removed 
by strip{l). Also note that if there were no unresolved external references after linking, the relo¬ 
cation information will be removed. 

The file section containing information for debugger support has three tables-the debug name 
table (DNTT), the source line table (SLT), and the value table (VT). These tables contain sym¬ 
bolic information used by the HP-UX debugger cdb{l). HP-UX compilers create this information 
under control of the -g option. 

When an a.out file is loaded into memory for execution, three logical segments are set up: the 
text segment, the data segment (initialized data followed by uninitialized, the latter actually being 
initialized to all O’s), and a stack. The text segment begins at location 0x0 in the core image; the 
header is not loaded. If the magic number (the first field in the header) is EXEC__MAGIC, it indi¬ 
cates that the text segment is not to be write-protected or shared, so the data segment will be 
contiguous with the text segment. If the magic number is SHARE_MAGIC or DEMAND_MAGIO, 
the data segment begins at the first 0 mod 0x1000 byte boundary following the text segment, and 
the text segment is not writable by the program; if other processes are executing the same a.out 
file, they will share a single text segment. If the magic number is DEMAND__MAGIO, the text and 
data segments are not read in from the file until they are referenced by the program. 

The stack will occupy the highest possible locations in the core image and grow downward (the 
stack is automatically extended as required). The data segment is only extended as requested by 
the brk(2) system call. 

The start of the text segment in the a.out file is given by the macro TEXT_OFFSET(hdr), where 
hdr is a copy of the file header. The macro DATA_OFFSET(hdr) provides the starting location of 
the data segment. 

The value of a word in the text or data portions that is not a reference to an undefined external 
symbol is exactly the value that will appear in memory when the file is executed. If a word in the 
text or data portion involves a reference to an undefined external symbol, as indicated by the relo¬ 
cation information (discussed below) for that word, then the value of the word as stored in the file 
is an offset from the associated external symbol. When the file is processed by the link editor and 
the external symbol becomes defined, the value of the symbol will be added to the word in the file. 
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Header 

The format of the a.out header for the MC68000 is as follows (segment sizes are in bytes): 
struct exec { 


MAGIC 

a_magic; 

/♦ magic number */ 

short 

a_stamp; 

/* version stamp ♦/ 

short 

a_unused; 


long 

a_sparehp; 


long 

fL_text; 

/* size of text segment */ 

long 

a_data; 

/* size of data segment */ 

long 

a_bss; 

/* size of bss segment */ 

long 

a_trsize; 

/* size of text relocation info ♦/ 

long 

a_drsize; 

/* size of data relocation info */ 

long 

a_pasint; 

/* size of interface text */ 

long 

2L_Jesyms; 

/* size of symbol table */ 

long 

a_dnttsize; 

/* debug name table size */ 

long 

a_entry; 

/* entry point of program */ 

long 

a sltsize; 

/* source-line table size */ 

long 

a__vtsize; 

/* value table size */ 

long 

a_spare3; 


long 

a__spare4; 



Pascal Interface Section 

The Pascal interface section consists of the ascii representation of the interface text for that Pas¬ 
cal module. 


The start of the Pascal interface section is given by the macro MODCAL_OFFSET(hdr). 

Symbol Table 

The symbol table consists of entries of the form: 


struct nlist { 
long 

unsigned char 
unsigned char 
short 
short 

}; 


n_rvalue; 

n_type; 

n_length; 

n_almod; 

n_^unused; 


Following this structure is n—length ascii characters which compose the symbol name. 


The n—type field indicates the type of the symbol; the following values are possible: 

00 undefined symbol 
01 absolute symbol 
02 text segment symbol 

03 data segment symbol 

04 bss segment symbol 

One of these values ANDed with 040 indicates an external symbol. One of these values ANDed 
with 020 indicates an aligned symbol. 

The start of the symbol table is given by the macro LESYM_OFFSET(hdr). 
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Relocation 

If relocation information is present, it amounts to eight bytes per relocatable datum. 
The format of the relocation data is: 
struct r_info { 


long 

r_address; 

short 

r__symbolnum; 

char 

r__segment; 

char 

r_length; 


}; 

The r—address field indicates the position of the relocation within the segment. 

The r—.segment field indicates the segment referred to by the text or data word associated with 
the relocation word: 

00 indicates the reference is to the text segment; 

01 indicates the reference is to initialized data; 

02 indicates the reference is to bss (uninitialized data); 

03 indicates the reference is to an undefined external symbol. 

The field rsymbolnum contains a symbol number in the case of external references, and is 
unused otherwise. The first symbol is numbered 0, the second 1, etc. 

The field r—length indicates the length of the datum to be relocated. 

00 indicates it is a byte 
01 indicates it is a short 
02 indicates it is a long 
03 indicates it is a special align symbol 

The start of the text relocation section is provided by the macro RTEXT_OFFSET(hdr). 

The start of the data relocation section is provided by the macro RDATA_OFFSET(hdr). 

SEE ALSO 

as(l), ld(l), nm(l), strip(l), magic(5). 
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NAME 

a.out - executable linker output file 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: HP 

Remarks: This manual entry describes the a.out file format for the Series 500. Refer to other 
a.out manual pages for information valid for other implementations. 

DESCRIPTION 

A.out is the output file of the linker ld{l). Ld will make a.out executable if there are no errors 
during compilation and linking, and no unresolved external references. 

This file has five sections - a file header, a segment table, a segment information section, a symbol 
table(s) section, and a name pool(s) section. It looks as follows: 


File Header 
Segment Table 
Segment Information 

— segment image (code/data) 

— fix-up information (loader) 

— relocation information {Id) 

Symbol Tables: 

— linker symbol table 

— information for debugger 
support 

Name Pool (strings) 


Note that the above pictorial representation represents the logical order of the file, not necessarily 
the physical order. A description of each section of the file follows. 

File Header 

The a.out file header is conceptually divided into two pieces. The first is a section of "scalar" 
values, and the second is a "file map" containing data pertaining to the rest of the file. The entire 
file header is made up of 128 bytes of information, 32 of which make up the scalar section. The 
following is a pictorial representation of the scalar section: 

Byte 
0 
4 
8 
12 
16 
20 
24 
28 


System ID : File Type 
Reserved for Future Use 
Flags 

Program Entry Point 
Version Stamp 
Memory Offset 
Working Set Guarantee 
Reserved for Future Use 
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Each horizontal "slice" represents a word made up of four eight-bit bytes. The first word is 
called the "magic munber", which is made up of two half-words called the system ID and the file 
type. The system ID identifies the target machine upon which the object code will run. The file 
type specifies whether or not the file is executable (hex 107), shareable (hex 108), or relocatable 
(hex 106). 

The third word is used to specify the settings of three flags. The left-most three bits of this word 
are significant; the remainder of the word is ignored. Bit 1, the left-most of the flag bits, marks 
the program as using a single data segment, if set. You can override this with the -T or -A Id 
options, which force the program to reside in one or two data segments, respectively. Bit 2 marks 
the file as relinkable, if set (meaning that the file contains relocation records and a symbol table). 
Bit 3 marks the file as debuggable, if set. 

The Program Entry Point word contains an external program pointer (EPP) referencing the 
starting code for the program. Ld normally assigns the starting address of the main program to 
this word. This can be changed with the -e linker option. 

The Version Stamp is a user-supplied 32-bit integer which is used to distinguish one version of an 
application program from another. The user can specify this integer using the -V ld[l) option at 
link time. 

The file map portion of the header looks as follows: 


Byte 


32 

Code Segment Tbl: offset 

36 

Code Segment Tbl: size 

40 

Code Seg Images: offset 

44 

Code Seg Images: size 

48 

Data Segment Tbl: offset 

52 

Data Segment Tbl: size 

56 

Data Seg Images: offset 

60 

Data Seg Images: size 

64 

Link Symbol Tbl: offset 

68 

Link Symbol Tbl: size 

72 

DNTT; offset 

76 

DNTT: Size 


Byte 


80 

VT: offset 

84 

VT: Size 

88 

SLT: offset 

92 

SLT: size 

96 

Name Pool: offset 

100 

Name Pool: size 

104 

Interface Info: offset 

108 

Interface Infor: size 

112 

Reserved for Future Use 

116 

Reserved for Future Use 

120 

Reserved for Future Use 

124 

Reserved for Future Use 
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Each offset entry in the file map shows where the given section starts, relative to the beginning of 
the a.out file. Each size entry gives the size, in bytes, for that section. 

Segment Table 

The segment table collects, in one place, all information about the code and data segments making 
up the program. The segment table consists of an array of entries. Each entry describes one code 
or data segment of the program. 

The following information is given for both code and data segment table entries: 

a segment name, which consists of an offset into the name pool, relative to the beginning 
of the name pool. This is useful for symbolically referring to code or data segments (not 
currently implemented). 

a segment type, which specifies one of three possible types of segments - code, direct data 
(in GDS), or indirect data (in GDS or EDS). 

a list of segment attributes. The segments can be paged, virtual, demand loadable, writ¬ 
able, and privileged. The linker sets the attributes for executable files. 

a segment offset, which references a particular code or data segment within the segment 
image area. The reference is given relative to the beginning of the segment image area. 

a segment size, which is the size, in bytes, of the particular code or data segment being 
described in the entry. 

a segment fixup size, which specifies the size, in bytes, of the loader fixup area in the par¬ 
ticular segment being described. 

a segment relocation information size, which specifies the number of bytes of relocation 
records for this segment. 

The following information is given for data segment table entries only: 

a segment limit, which specifies the maximum number of bytes that the indirect data seg¬ 
ment can contain. Attempting to increase the size beyond this stated limit results in an 
error. The linker assigns a default value of 1.5 megabytes to this field, but it may be 
changed with the -m chatr{l) option. 

a segment zero-padding size, which is a byte count of the uninitialized data area. The 
linker computes this value from the data relocation records. 

The following information is given for code segment table entries only: 

a segment local procedures count, which specifies the number of procedures defined in that 
segment, but only known locally within it. 

a segment external procedures count, which specifies the number of procedures defined in 
that segment, but externally known. 

Several words are left unused in each segment table entry to allow for future growth. 

Segment Information 

This section of the file contains the segment images for each segment included in the final, execut¬ 
able file. This section contains a subsection for each program segment. Each subsection is in turn 
made up of three parts - the contents of the segment (code or data), a list of pointers that the 
loader must "fix up" in that segment, and the relocation records for that segment. Each subsec¬ 
tion looks as follows: 


Code/Data Image 
Loader Initialization. Information 
Loader Fixup Information 
Relocation Records 
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The code image contains the compiled machine code for each program segment. The data image 
contains an image of initialized data for the program. Contained in this code are pointers. The 
loader fixup information area contains offsets that reference these pointers (the offsets are given 
relative to the beginning of the code/data image area). These offsets must be "fixed up" at run 
time (i.e., the program loader exec must update the segment number fields with the correct 
values). The linker generates the loader fixup information. 

Symbol Tables 

The linker symbol table contains data on relocatable symbols relevant to the linker (e.g. name and 
type for each global symbol). Refer to nm{l) (Series 500 only) for a complete description of each 
symbol type and the parameters associated with them. The contents of the symbol table may be 
listed in several different ways with nm. 

Name Pool 

The name pool contains a list of null-terminated strings, which specify the names of the symbols 
in the program. The symbol table entries contain indexes into the name pool instead of the 
names themselves. This permits arbitrarily long names to be used instead of fixed-length names. 
The first string in the name pool is always a null string. This enables zero to be used as an index 
into the name pool for entities which have no names. 

SEE ALSO 

chatr(l), ld(l), nm(l), strip(l), magic(5). 
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NAME 

acct - per-process accounting file format 

HP-UX COMPATIBILITY 

Level: HP-UX/EXTENDED 

Origin: System V 
SYNOPSIS 

#include <sys/acct.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/EXTENDED 

Origin: System V 

DESCRIPTION 

Files produced as a result of calling acct {2) have records in the form defined by <sys/acct.h>, 
whose contents are: 


typedef ushort comp_t; /* "floating point" */ 

/* 13-bit fraction, 3-bit exponent */ 


struct acct 
{ 

char 

ac__flag; 

/* Accounting flag ♦/ 

char 

ac_stat; 

/♦ Exit status */ 

ushort 

ac_uid; 

/♦ Accounting user ID */ 

ushort 

ac_gid; 

/* Accounting group ID */ 

dev_t 

ac_tty; 

/♦ control typewriter ♦/ 

time_t 

ac_btime; 

/* Beginning time */ 

comp_t 

ac_utime; 

/* acctng user time in clock ticks */ 

comp_t 

ac_stime; 

/* acctng system time in clock ticks */ 

comp_t 

ac_etime; 

/* acctng elapsed time in clock ticks */ 

comp_t 

ac_mem; 

/* memory usage in clicks ♦/ 

comp_t 

ac_io; 

/* chars trnsfrd by read/write */ 

comp_t 

ac_rw; 

/♦ number of block reads/writes ♦/ 

char 

}; 

ac_comm[8]; 

/ ♦ command name * / 

#define AFORK 

01 

/* has executed fork, but no exec ♦/ 

#define ASU 

02 

/* used super-user privileges */ 

#define ACCTF 

0300 

/* record type: 00 = acct */ 


In ac—flag^ the AFORK flag is turned on by each fork{2) and turned off by an exec (2). The 
ac—comm field is inherited from the parent process and is reset by any exec. Each time the sys¬ 
tem charges the process with a clock tick, it also adds to ac—mem the current process size, com¬ 
puted as follows: 

(data size) + (text size) / (number of in-core processes using text) + 
sum of ((shared memory segment size) / (number of in-core processes attached to seg¬ 
ment)) 

The value of ac^mem/ (acstime + ac—utime) can be viewed as an approximation to the mean 
process size, as modified by text-sharing. 
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The structure tacct.h, which resides with the source files of the accounting commands, represents 
the total accounting format used by the various accounting commands: 

/* 

* total accounting (for acct period), also for day 

*! 


struct tacct { 



uid_t 

ta_uid; 

/* userid */ 

char 

ta name [8]; 

/ * login name * / 

float 

ta_cpu[2]; 

/* cum. cpu time, p/np (mins) ♦/ 

float 

ta_kcore[2]; 

/* cum kcore-minutes, p/np */ 

float 

ta_con[2]; 

/* cum. connect time, p/np, mins ♦/ 

float 

ta_du; 

/* cum. disk usage */ 

long 

ta_pc; 

/* count of processes */ 

unsigned short 

ta_sc; 

/* count of login sessions */ 

unsigned short 

ta_dc; 

/* count of disk samples */ 

short 

}; 

ta^ee; 

/* fee for special services */ 

HARDWARE DEPENDENCIES 



Series 500; 




ac—mem includes only certain resident segments still held by a process when it ter¬ 
minates. Because ac—mem does not account for shared or virtual memory, or for changes 
in the amount of memory allocated dynamically, ac_mem / [acstime -I- ac^utime) may 
not always furnish a good approximation of memory usage. 

SEE ALSO 

acct(2), exec(2), fork(2). 

acct(lM), and acctcom(l) in the HP-UX Reference. 

BUGS 

The ac—mem value for a short-lived command gives little information about the actual size of the 
command, because ac_mem may be incremented while a different command (e.g., the shell) is 
being executed by the process. 
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NAME 

ar - common archive file format 

SYNOPSIS 

^include <ar.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Ar(l) is used to concatenate several files into an archival file. Archives are used mainly as 
libraries to be searched by the link editor ld(l). 

Each archive begins with the archive magic string. 

#define ARMAG "!<arch>\n" /* magic string */ 

^define SARMAG 8 /* length of magic string +/ 

Each archive which contains object files (see a.oui(5)) includes an archive symbol table. This 
symbol table is used by the link editor ld(l) to determine which archive members must be loaded 
during the link edit process. The archive symbol table (if it exists) is always the first file in the 
archive (but is never listed) and is automatically created and/or updated by ar. 

Following the archive magic string are the archive file members. Each file member is preceded by 
a file member header which is of the following format: 

#define ARFMAG "‘\n" /* header trailer string */ 


struct ar_Jidr /* file member header */ 

{ 


char 

ar_name[16]; 

/* ’/’ terminated file member name */ 

char 

ar_date[12]; 

/* file member date */ 

char 

ar_uid[6]; 

/* file member user identification */ 

char 

ar_gid[6]; 

/* file member group identification ♦/ 

char 

ar_mode[8]; 

/* file member mode (octal) */ 

char 

ar_size[10]; 

/* file member size */ 

char 

ar_imag[2]; 

/* header trailer string */ 


}; 


All information in the file member headers is in printable ASCII. The numeric information con¬ 
tained in the headers is stored as decimal numbers (except for ar—mode which is in octal). Thus, 
if the archive contains printable files, the archive itself is printable. 

The av—name field is blank-padded and slash (/) terminated. The ar—date field is the 
modification date of the file at the time of its insertion into the archive. Common format archives 
can be moved from system to system as long as the portable archive command ar(l) is used. 
Note that older versions or ar(l) did not use the common archive format, and those archives can¬ 
not be read or written by the common archiver. The conversion tool arcv{l) is provided for 
changing non-common format archives to this format. 

Each archive file member begins on an even byte boundary; a newline is inserted between files if 
necessary. Nevertheless the size given reflects the actual size of the file exclusive of padding. 

Notice there is no provision for empty areas in an archive file. 

If the archive symbol table exists, the first file in the archive has a zero length name (i.e., 
ar_name[0] == ’/’). The contents of this archive member are machine dependent. Further 
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details can be found in the ranlib{b) manual page. 

SEE ALSO 

ar(l), arcv(l), ld(l), strip(l), ranlib(5). 

WARNING 

Strip(l) will remove all archive symbol entries from the header. The archive symbol entries must 
be restored via the ts option of the ar(l) command before the archive can be used with the link 
editor ld{l). 
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NAME 

BIF - Bell Interchange Format utilities 

HP-UX COMPATIBILITY 

Level: Bell System III - HP-UX/NUCLEUS 

Origin: HP 

DESCRIPTION 

BIF (Bell Interchange Format) is the name given to the format of mounted media used by HP- 
UX series 200 revisions 2.0 and 2.1. This format is based upon that used in System HI Unix. 

These utilities are provided for reading and writing data to and from BIF volumes. These utilities 
(referred to hereafter as bif*{l)) may be used to retrieve and store information on a BIF volume. 

The utilities are the only utilities within HP-UX where the internal contents of a BIF 

volume are known. To the rest of HP-UX a BIF volume is simply a file/disk containing some 
unspecified data. You must not use mount (1) on a BIF volume, since the operating system does 
not recognize it. 

BIF file names are specified to the 6^7*(l) utilities by concatenating the HP-UX path name for the 
BIF volume with the BIF file name, separating the two with a colon (:). For example, 

/dev/fd.O.’/users/ivy specifies BIF file /users/ivy within HP-UX device special file 
/dev/fd.O. 

Note that this file naming convention is applicable only for use as arguments to the bif*{l) utili¬ 
ties and does not constitute a legal path name for any other use within HP-UX. The shell sh(l) 
"meta" characters: * ? and [...] do not work for specifying an arbitrary pattern for file name 
matching when using the BIF utilities. 

If the device name and a trailing colon are specified without a file or directory name following (e.g. 
/dev/rfd.O:), then the root (/) of the BIF file system is assumed by convention. 

A primitive form of data protection is provided by a lockfile /tmp/BIF..LCK that only allows one 
process and it’s immediate children to use the bif utilities at a time. 

SEE ALSO 

bifchmod(l), bifchown(l), bifcp(l), bifdf(l), biffind(l), bilfsck(l), biffsdb(l), bifls(l), bifmkdir(l), 
bifmkfs(l), bifrm(l). 
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NAME 

checklist - static information about the file systems. 

SYNOPSIS 

#include <checklist.h> 

HP-UX COMPATIBILITY 

Level: Large Machine/HP Extension 

Origin: HP, System V and UCB 

DESCRIPTION 

Checklist is an ASCII file and resides in directory /etc. It is only read by programs, and not writ¬ 
ten; it is the duty of the system administrator to properly create and maintain this file. 
/etc/checklist contains a list of mountable file system entries. The fields within each entry of a 
file system are separated by one or more blanks. Each file system entry is contained on a separate 
line. The order of entries in /etc/checklist is important because fsck^ mount, and umount sequen¬ 
tially iterate through /etc/checklist. 

Each file system entry must contain a special file name and may additionally contain all of the 
following fields, in order: 
block special file name 
directory 
type 

pass number on parallel fsck 
backup frequency 
comment 

These additional fields are ignored in an HP-UX system if the set of system administration tools 
implemented on that system does not support them. 

The special file name is either a character or block special file name. This field is used by 

the fsck(lM) command. 

The block special file name is used by the moimt(lM) and other commands. 

The directory is the name of the root of the mounted file system which corresponds to the block 
special file name. The directory must already exist and must be given as an absolute path name. 

Type can be "rw", "ro", "sw" or "xx". If type is "rw" or "ro" then the file system whose name is 
given in the block special file field is mounted read-write or read-only on the specified directory 
by mount -a. If type is "sw" then the special file name is made available as a piece of swap 
space by the swapon{lM) command. The fields pass number and backup frequency are ignored for 
"sw" entries. Entries marked "xx" are ignored by all commands and can be used to mark unused 
sections. If type is specified as either "xx" or "sw" the entry is ignored by the mount{lM) com¬ 
mand. 

The pass number field is used by the fsck{lM) command to determine the order in which file sys¬ 
tem checks are done when using the -p option of fsck. The root file system should be specified 
with a pass number of 1, and other file systems should have larger numbers. File systems within 
a drive should have distinct numbers, but file systems on different drives can be checked on the 
same pass to utilize possible parallelism available in the hardware. A file system with a pass 
number of zero will be ignored by the fsck(lM) command. If a pass number is not present, fsck 
will check each such file system sequentially after all eligible file systems with pass numbers have 
been checked. 

The backup frequency field is reserved for possible use by future backup utilities. 

The comment field is an optional field which starts with a pound sign (#) and ends with a new- 
line. Space from the backup frequency up to the comment field, if present, or the newline is 
reserved for future use. 
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Examples of file system entries specified in /etc/checklist; 

For system which supports only special file name field: 

/dev/rdsk/OsO 

For system which supports multi-fields: 

/dev/rdsk/OsO /dev/dsk/OsO / rw 1 0 #root disc 

HARDWARE DEPENDENCIES 
Series 500: 

All of the optional fields in a file system entry will be ignored. 

Series 200 and 300 

There is no limit to the number of special file names in /etc/checklist However, the com¬ 
mands mount -a and umount -a give an error if the number of mountable file system 
entries in /etc/checklist exceeds NMOUNT. 

SEE ALSO 

fsck(lM), getfsent(3X), mount(lM), swapon(lM). 
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NAME 

col__seq_8 - Collating sequence table for languages with 8-bit character sets 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Native Language Support: 

8-bit data, customs 

DESCRIPTION 

There are four language dependent collation algorithms for European languages. These algorithms 
are: 

2-to-l Conversions; Some languages, like Spanish, require two adjacent characters to occupy 
one position in the collating sequence. Examples are "CH" (which follows "C") and "LL" (which 
follows "L"). 

l-to-2 Conversions; Some languages, like German, require one character (e.g. "sharp S") to 
occupy two adjacent positions in the collating sequence. 

Don’t care Characters; Some languages designate certain characters to be ignored in character 
comparisons. For example, if is a "Don’t Care" character, then the strings "REACT" and 
"RE-ACT" would equal each other when compared. 

Case and Accent Priority; Many languages require a "two pass" collating algorithm: in pass 
one, the accents are stripped off the letters and the resulting two strings are compared; if they are 
equal, a second pass with the accents back in place is performed to break the tie. The case of 
letters may also be used in this fashion. 

This table has four sections - a file header, a sequence table, a 2-to-l mapping table and a l-to-2 
mapping table. 

_ Header _ 

Sequence Table 
2-to-l Mapping Table 
l-to-2 Mapping Table 

Length and pointers are in units of two bytes. 

Header; 



Byte 0 1_ 

_Byte 1_ 

0 

Table Length 

2 

Language Id Number 

4 

Reserved 

6 

Pointer to Sequence Table 

8 

Length of Sequence Table 

10 

Pointer to 2-to-l Mapping Table 

12 

Length of 2-to-l Mapping Table 

14 

Pointer to l-to-2 Mapping Table 

16 

Length of l-to-2 Mapping Table 

18 

Lowest Char 

1 Highest Char 

20 

Reserved I 
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Sequence Table: 

Sequence Entry 0 
Sequence Entry 1 
(other entries from 2-254) 

Sequence Entry 255 

The byte value of a character is used as an index into the sequence table. 

Sequence Entry Format: Each entry in the sequence table above uses two bytes and has one of 
the following formats: 


First Byte 

S 

econd Byte 

Format Type 

Bits: 15-8 

7-6 

5-4-.V2-1-0 


0 

00 

0 

don’t-care characters 

sequence no. 

00 

priority 

all 1-to-l mapped characters w/o priority 

sequence no. 

01 

index 

2-to-l mapped characters 

seq # (l.ch) 

10 

index 

l-to-2 mapped characters 


The 6-bit index indexes into either the 2-to-l or the l-to-2 mapping table. 
Mapping Table for 2-to-l Mapped Characters 

2-to-l Mapping Table 
Entry Pointer 1 
Entry Pointer 2 
(other entry pointers) 

Entry Pointer n 


Sequence Entry Format for Mapped Pairs 


Byte 0 


Byte 1 


0 


Legal Char 1 


Sequence Entry for this Pair 


(other mapped pair entries) 


Legal Char n 


Sequence Entry for This Pair 


Sentinel: -1 


priority 


The "legal" 2-to-l characters are listed for each particular character. "Legal" means that the 
combination of two characters is treated as a single character. If a match is found, then the 
corresponding sequence entry is used for the two. Whenever a legal successor is not found in the 
table, the character is treated according to 1-to-l mapping, and the priority in the last entry, 
combined with sequence number of the character, creates the sequence entry. 
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Mapping Table for l-to-2 Mapped Characters 

l-to-2 Mappine^ Table 
Sequence Entry 
Sequence Entry 
(other sequence entries) 

Sequence Entry 

Entries in the l-to-2 mapping table have the same format as entries in the sequence table. The 
sequence number of the first character is known from the entry in the sequence table. The 
sequence number of the second character is found in the l-to-2 mapping entry, and the priority is 
used for both characters. 

SEE ALSO 

sort(l), nl_jstring(3C). 
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NAME 

core - format of core image file 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD - Assembly option 

Origin: System III 

DESCRIPTION 

The HP-UX system writes out a core image of a terminated process when any of various errors 
occur. See signalifi) for the list of reasons; the most common are memory violations, illegal 
instructions, floating point exceptions, and user-generated quit signals. The core image is called 
core and is written in the process’s working directory (provided it can be; normal access controls 
apply). A process with an effective user ID different from the real user ID will not produce a core 
image. 

The first section of the core image is a header which contains information about the terminated 
process. The remainder represents the actual contents of the user’s core area when the core image 
was written. This area contains the stack, user global data, and heap segments. The last object in 
the core image is the code segment fixup map which maps user code segments into real addresses. 

The format of the information in the first section is described by the user structure of the system, 
defined in <sys/user.h>. 

SEE ALSO 

cdb(l), setuid(2), signal(2). 
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NAME 

cpio - format of cpio archive 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

The header structure, when the -c option of cpio(l) is not used, is: 
struct { 

short h_magic, 

h_dev; 

ushort h_ino, 

h_mode, 

h_uid, 

h_gid; 

short h_nlink, 

h_rdev, 

h_mtime[2], 

h_namesize, 

h_filesize[2]; 

char h_name[h_jQamesize rounded to word]; 

}Hdr; 

When the -c option is used, the header information is described by: 

sscanf(Chdr,"%6ho%6ho%6ho%6ho%6ho%6ho%6ho%6ho%lllo%6ho%lllo", 

&:Hdr.h_magic,&;Hdr.h_dev,&;Hdr.h_ino,&;Hdr.h_mode, 

&;Hdr.h_uid,&;Hdr.h_gid,&:Hdr.h_nlink,&:Hdr.h_rdev, 

&:Longtime,&:Hdr.h_namesize,&:Longfile); 

Longtime and Longfile are equivalent to Hdr.h^mtime and Hdr.h—filesize, respectively. The 
contents of each file is recorded together with other items describing the file. Every instance of 
h—magic contains the constant 070707 (octal). The items h—dev through h^mtime have mean¬ 
ings explained in stat{2). The length of the null-terminated path name h—uame^ including the 
null byte, is given by h—namesize. 

The last record of the archive always contains the name TRAILER!!!. Directories and the trailer 
are recorded with h—filesize equal to zero. 

It will not always be the case that h_dev and h_ino correspond to the results of stat(2), but the 

values are always sufficient to tell whether two files in the archive are linked to each other. 

When a device special file is archived by HP-UX cpio (using -x), h_rdev will contain a magic 
constant which is dependent upon the implementation which is doing the writing. H^rdev flags 

the device file as an HP-UX 32-bit device specifier, and h_filesize will contain the 32-bit device 

specifier (see stat(2)). 

Special files are not restored, and cpio(l) generates a warning, if either h_filesize is zero, h_rdev 

is non-zero, or the identifying information is not that for the restoring system. If the -x option is 
not present, special files are not archived or restored. Non-HP-UX device special files are never 
restored. 

SEE ALSO 

cpio(l), find(l), stat(2). 
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NAME 

dialups, d_passwd - dialup security control 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: Capability from System V, page by HP. 

DESCRIPTION 

Dialups and d—.passwd are used to control the dialup security feature of login[l). If /etc/dialups 
is present, the first word on each line is compared with the name of the line upon which the login 
is being performed. (Including the /dev/, as returned by ttyname{3)). If the login is occurring 
on a line found in dialups, dialup security is invoked. Anything after a space or tab is ignored. 

When dialup security is invoked, login{l) will request an additional password, and check it 
against that found in /etc/d—passwd. The command name found in the "program to use as 
Shell" field of /etc/passwd is used to select the password to be used. Each entry in d—passwd 
consists of three fields, separated by colons. The first is the command name, matching an entry in 
passwd. The second is the encrypted password to be used for dialup security for those users log¬ 
ging in to use that program. The third is commentary, but the second colon is required to delimit 
the end of the password. A null password is designated with two adjacent colons. The entry for 
/hin/sh is used if no other entry matches the command name taken from passwd. 

FILES 

/etc/dialups Dial in tty lines 
/etc/d_passwd Passwords 

SEE ALSO 

login(l), passwd(5). 
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NAME 

dir - format of directories 
SYNOPSIS 

#include <types.h> 

^include <sys/dir.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB and HP 

Remarks: This entry describes the directory format for the HFS file system. Refer to other 
dir(5) manual pages for information valid for other implementations. 

DESCRIPTION 

A directory behaves exactly like an ordinary file, except that no user may write into a directory. 
The fact that a file is a directory is indicated by a bit in the flag word of its i-node entry (see 
/s(5)). The structure of a directory entry as given in the dir.h include file is: 


#define DIRSIZ 

14 


#define DIR_PADSIZE 

10 


struct direct { 

u_long 

d_ino; 

/* inode number of entry */ 

u_short 

d_reclen; 

/* length of this record */ 

u_short 

d_namlen; 

/* length of string in d_jname */ 

char 

d_name[DIRSIZl; 

/* name must be no longer than 1 

char 

d_pad[DIR_PADSIZE]; 


}; 

By convention, the first two entries in each directory are for . and .. ("dot" and "dot dot"). The 
first is an entry for the directory itself. The second is for the parent directory. The meaning of .. 
is modified for the root directory of the master file system; there is no parent, so .. and . have 
the same meaning. 

The d&ect structure defined here is the actual directory format for the HFS file system and is not 
compatible with other HP-UX supported file systems. The direct structure defined in 
/usr/include/ndir.h should be used in conjunction with the directory(3C) library routines for 
compatibility across all HP-UX supported file systems. 

SEE ALSO 

fs(5), directory(3C). 
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NAME 

dir - format of directories 
SYNOPSIS 

#include <types.h> 

#include <sys/dir.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Remarks: This entry describes the SDF directory format for Series 500. Refer to other dir{^) 
manual pages for information valid for other implementations. 

DESCRIPTION 

A directory behaves exactly like an ordinary file, except that no user may write into a directory. 
The fact that a file is a directory is indicated by a bit in the flag word of its i-node entry (see 
inode{f>)). The structure of a directory entry as given in sys/dir.h is: 


#ifndef DIRSIZ 



#define DIRSIZ 

14 


#endif 



struct direct 

r 



\ 

char 

d—Jiame [DIRSIZ+2]; 

/* 16-char file name ♦/ 

short 

d_object-type; 

/* not referenced by HP-UX */ 

short 

d_file_code; 

/* not referenced by HP-UX */ 

ino_t 

d—ino; 

/* use fir # for i-node */ 


}; 

The SDF directory implementation eliminates entries for . and ... Instead, this information is 
available as part of the i-node. 

File names are stored in directories in a special manner in two cases: 

When a file name contains embedded blanks, the blanks are represented by null char¬ 
acters on the disc. This is apparent when accessing the disc in raw (character) mode. 

When a file name is blank padded, all unspecified characters are set to blanks. Again, 
this is apparent only when reading from the disc in raw mode. 

When a director has been opened vi opew(2), file names appear as null-terminated, and contain 
embedded blanks where they belong. 

The direct structure defined here is the actual directory format for the SDF file system, and is not 
compatible with other file systems supported on HP-UX. The direct structure defined in 
/usr/include/ndir.h should be used in conjunction with the directory(3C) library routines for 
compatibility across all HP-UX supported file systems. 

SEE ALSO 

fs(5), inode(5), directory(3C). 
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NAME 

dir - format of directories 
SYNOPSIS 

^include <types.h> 

#include <sys/dir.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

Remarks: This entry describes the directory format for the Bell file system. Refer to other dir{5) 
manual pages for information valid for other implementations. 

DESCRIPTION 

A directory behaves exactly like an ordinary file, except that no user may write into a directory. 
The fact that a file is a directory is indicated by a bit in the flag word of its i-node entry (see 
fs{b)). The structure of a directory entry as given in the dir.h include file is: 

#ifndef DIRSIZ 

#define DIRSIZ 14 

#endif 

struct direct 

{ 

ino_t d_ino; 

char d_name[DIRSIZ]; 

}; 

By convention, the first two entries in each directory are for . and .. ("dot" and "dot dot"). The 
first is an entry for the directory itself. The second is for the parent directory. The meaning of .. 
is modified for the root directory of the master file system; there is no parent, so .. and . have 
the same meaning. 

The direct structure defined here is the actual directory format for the Bell file system and is not 
compatible with other HP-UX supported file systems. The direct structure defined in 
/usr/include/ndir.h should be used in conjunction with the directory (3C) library routines for 
compatibility across all HP-UX supported file systems. 

SEE ALSO 

fs(5), directory(3C). 
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NAME 

disktab - disc description file 
SYNOPSIS 

#include <disktab.h> 

HP-UX COMPATIBILITY 

Level: Large Machine/HP Extension/HFS 

Origin: HP and UCB 

DESCRIPTION 

Disktab is a simple data base which describes disc geometries and disc section characteristics. 
Entries in disktab consist of a number of separated fields. The first entry for each disc gives the 
names which are known for the disc, separated by ‘ I ’ characters. The last name given should be a 
long name fully identifying the disc. 

The following list indicates the normal values stored for each disc entry. Sectors are of size 
DEV_BSIZE, defined in <sys/param.h> on your system. 


Name Type Description 

ns 

num 

Number of sectors per track 

nt 

num 

Number of tracks per cylinder 

nc 

num 

Total number of cylinders on the disc 

bO 

num 

Block size for section ‘0’ (bytes) 

bl 

num 

Block size for section ‘1’ (bytes) 

b<n> 

num 

Block size for section ‘<n>’ (bytes) 

fO 

num 

Fragment size for section ‘0’ (bytes) 

fl 

num 

Fragment size for section ‘1’ (bytes) 

f<n> 

num 

Fragment size for section ‘<n>’ (bytes) 

sO 

num 

Size of section ‘0’ in sectors 

si 

num 

Size of section T’ in sectors 

s<n> 

num 

Size of section ‘<n>’ in sectors 

rm 

num 

Revolution per minute 

ty 

str 

Type of disc (e.g. removable, winchester) 

Example: 


hp7914: 

:ty=winchester:ns#16:nt#7:nc#1061:s0#118832\ 

:b0#8192:f0#1024:rm#3600: 

HARDWARE 

DEPENDENCIES 

Series 200: 



The Series 200 SM HP-UX 5.0 release can have only one section per disc drive. 

FILES 

/etc/disktab 

SEE ALSO 

newfs(lM) 
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NAME 

errfile - system error logging file 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Remarks: This manual page describes errfile as implemented on the Series 500. Refer to other 
errfile manual pages for information valid for other implementations. 

DESCRIPTION 

Errfile is a logging file containing lines of ASCII text. Each line describes certain system errors 
that have occurred, or warnings about serious system conditions. Only those system error mes¬ 
sages deemed serious enough to be of interest to the system administrator are logged. Urgent 
messages are also written to /dev/console. 

HP-UX creates errfile if it does not exist. 

The system administrator should check the contents of errfile periodically and note errors that 
need attention. Also, errfile tends to grow without bounds, so outdated information needs to be 
removed on a regular basis. 

FILES 

usr/adm/errfile 
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NAME 

fs - format of file system volume 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/param.h> 

^include <sys/fs.h> 

#include <sys/ino.h> 

#include <sys/inode.h> 

^include <sys/sysmacros.h> 

HP-UX COMPATIBILITY 

Level: Large Machine/HP Extension/HFS 
Origin: HP and UCB 4.2 

DESCRIPTION 

Every file system storage volume has a common format for certain vital information. The first 8 
kbytes on a volume contain a volume header which identifies that volume as a LIE volume. Such 
volume may be divided into a number of sections. 

Each section can contain a file system. The first 8 kbytes in each section is ignored, except where 
it coincides with the volume header discussed above. The actual file system begins next with the 
super block. The layout of the super block as defined by the include file <sys/fs.h> is: 

#define FS_MAGIC 0x011954 

#define FS_CLEAN 0x17 

#define FS_OK 0x53 

#define FS_NOTOK 0x31 
struct fs { 


struct 

fs *fs_link; 


/* linked list of file systems */ 

struct 

fs *fs_rlink; 


/* used for incore super blocks */ 

daddr. 

_t fs_^blkno; 

/* addr of super-block in filesys */ 

daddr. 

_t fs_cblkno; 

/* offset of cy 1-block in filesys */ 

daddr. 

_t fs_iblkno; 

/* offset of inode-blocks in filesys */ 

daddr. 

_t fs_dblkno; 

/* offset of first data after eg */ 

long 

fs_cgoffset; 


/* cylinder group offset in cylinder */ 

long 

fs_cgmask; 


/* used to calc mod fs__ntrak */ 

time_ 

t fs_time; 


/* last time written */ 

long 

fs^ize; 

!* 

number of blocks in fs */ 

long 

fs_dsize; 


/* number of data blocks in fs */ 

long 

fs_ncg; 


/* number of cylinder groups */ 

long 

fs_bsize; 


/* size of basic blocks in fs */ 

long 

fs_fsize; 


/* size of frag blocks in fs */ 

long 

fs_frag; 

r 

number of frags in a block in fs */ 

/* these are configuration parameters */ 

long 

fs_minfree; 


/* minimum percentage of free blocks */ 

long 

fs_rotdelay; 


/* num of ms for optimal next block */ 

long 

fs_rps; 


/* disk revolutions per second */ 

/* these fields can be computed from the others */ 

long 

fs_bmask; 


/* “blkoff” calc of blk offsets */ 

long 

fs_fmask; 


/* “fragoff” calc of frag offsets */ 

long 

fs_bshift; 


/* “Iblkno” calc of logical blkno */ 

long 

fs_fshift; 


/* “numfrags” calc number of frags */ 

/* these are configuration parameters */ 

long 

fs__maxcontig; 


/* max number of contiguous blks */ 

long 

fs__maxbpg; 


/* max number of blks per cyl group */ 


/* these fields can be computed from the others */ 
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/* block to frag shift */ 

/* fsbtodb and dbtofsb shift constant */ 
/* actual size of super block */ 

/* csum block offset */ 

/* csum block number */ 

/* value of NINDIR */ 

/* value of INOPB */ 

/* value of NSPF */ 

/* reserved for future constants */ 

/* sizes determined by number of cylinder groups and their sizes */ 

daddr_t fs_csaddr; /* blk addr of cyl grp summary area */ 

long fs_cssize; /* size of cyl grp summary area */ 

long fs_cgsize; /* cylinder group size */ 

/* these fields should be derived from the hardware */ 


long 

fs_fragshift; 

long 

fs_fsbtodb; 

long 

fs_sbsize; 

long 

fs_csmask; 

long 

fs_csshift; 

long 

fs_nindir; 

long 

fs_inopb; 

long 

fs_nspf; 

long 

fs_sparecon[6]; 


long 

fs_ntrak; 

/* tracks per cylinder */ 

long 

fs_nsect; 

/* sectors per track */ 

long 

fs_spc; 

/* sectors per cylinder */ 


/* this comes from the disk driver partitioning */ 

long fs_ncyl; /* cylinders in file system */ 

/* these fields can be computed from the others */ 


long 

fs_cpg; 

!* 

cylinders per group */ 

long 

fs—ipg; 

r 

i-nodes per group */ 

long 

fs-fpg; 

!* 

blocks per group * fs_frag */ 


/* this data must be re-computed after crashes */ 

struct csum fs_cstotal; /* cylinder summary information */ 

/* these fields are cleared at mount time */ 

char fs_fmod; /* super block modified flag */ 

char fs_clean; /* file system is clean flag */ 

char fs_ronly; /* mounted read-only flag */ 

char fs_flags; /* currently unused flag */ 

char fs_fsmnt[MAXMNTLEN]; /* name mounted on */ 

/* these fields retain the current block allocation info */ 

long fs_cgrotor; /* last eg searched */ 

struct csum *fs_csp[MAXCSBUFS];/* list of fs_cs info buffers */ 

long fs_cpc; /* cyl per cycle in postbl */ 

short fs_postbl[MAXCPG][NRPOS];/* head of blocks for each rotation */ 

long fs_magic; /* magic number */ 

char fs__name[6]; /* name of file system */ 

char fs_fpack[6]; /* pack name of file system */ 

u_char fs_rotbl[l]; /* list of blocks for each rotation */ 

/* actually longer */ 

}; 

A file system consists of a number of cylinder groups. Each cylinder group has i-nodes and data. 

A file system is described by its super-block, which in turn describes the cylinder groups. The 
super-block is critical data and is replicated in each cylinder group to protect against catastrophic 
loss. This is done at file system creation time and the critical super-block data does not change, 
so the copies need not be referenced further unless disaster strikes. 

Addresses stored in i-nodes are capable of addressing fragments of ‘blocks’. File system blocks of 
at most size MAXBSIZE can be optionally broken into smaller pieces, each of which is address¬ 
able; these pieces may be DEV_BSIZE, or some multiple of a DEV_BSIZE unit. 

Large files consist of exclusively large data blocks. To avoid undue wasted disk space, the last 
data block of a file is allocated only as many fragments of a large block as are necessary, if that 


Hewlett-Packard 


-2- 


July 10, 1985 



FS(5) 


(HFS Implementation) 


FS(5) 


file is small enough to not require indirect data blocks. The file system format retains only a single 
pointer to such a fragment, which is a piece of a single large block that has been divided. The size 
of such a fragment is determinable from information in the i-node, using the “blksize(fs, ip, Ibn)” 
macro. 

The file system records space availability at the fragment level; to determine block availability, 
aligned fragments are examined. 

I-numbers begin at 0. I-nodes 0 and 1 are reserved. I-node 2 is used for the root directory of the 
file system. The lostH-found directory is given the next available inode when it is initially created 
by mkfs. 

fs—minfree gives the minimum acceptable percentage of file system blocks which may be free. If 
the freelist drops below this level only the super-user may continue to allocate blocks. This may 
be set to 0 if no reserve of free blocks is deemed necessary, however severe performance degrada¬ 
tions will be observed if the file system is run at greater than 90% full; thus the default value of 
fs—minfree is 10%. 

The best trade-off between block fragmentation and overall disk utilization and performance 
varies for each intended use of the file system. Suggested values can be found in the System 
Administrator’s Manual for each implementation. 

Cylinder group related limits: Each cylinder keeps track of the availability of blocks at different 
rotational positions, so that sequential blocks can be laid out with minimum rotational latency. 
NRPOS is the number of rotational positions which are distinguished. For example, with NRPOS 
8 the resolution of the summary information is 2ms for a typical 3600 rpm drive. 

fs—rotdelay gives the minimum number of milliseconds to initiate another disk transfer on the 
same cylinder. It is used in determining the rotationally optimal layout for disk blocks within a 
file; the default value for fs—rotdelay is 2ms. Suggested values of fs__rotdelay for different disks 
can be found in the System Administrator’s Manual. 

Each file system has a statically allocated number of i-nodes. An i-node is allocated for each 
NBPI bytes of disk space. The i-node allocation strategy is extremely conservative. 

MAXIPG bounds the number of i-nodes per cylinder group, and is needed only to keep the struc¬ 
ture simpler by having only a single variable size element (the free bit map). 

N.B.: MAXIPG must be a multiple of INOPB(fs). 

MINBSIZE is the smallest allowable block size. With a MINBSIZE of 4096 it is possible to create 
files of size 2^32 with only two levels of indirection. MINBSIZE must be big enough to hold a 
cylinder group block, thus MINBSIZE must always be greater than sizeof(struct eg). Note that 
super blocks are never more than size SBSIZE. 

The path name on which the file system is mounted is maintained in fs—fsmnt. MAXMNTLEN 
defines the amount of space allocated in the super block for this name. The limit on the amount 
of summary information per file system is defined by MAXCSBUFS. It is currently parameterized 
for a maximum of two million cylinders. 

Per cylinder group information is summarized in blocks allocated from the first cylinder group’s 
data blocks. These blocks are read in from fs—csaddr (size fs^cssize) in addition to the super 
block. 

N.B.: sizeof (struct esum) must be a power of two in order for the “fs_cs” macro to work. 

Super block for a file system: MAXBPC bounds the size of the rotational layout tables and is 
limited by the fact that the super block is of size SBSIZE. The size of these tables is inversely 
proportional to the block size of the file system. The size of the tables is increased when sector 
sizes are not powers of two, as this increases the number of cylinders included before the rota¬ 
tional pattern repeats ( fs—cpc). The size of the rotational layout tables is derived from the 
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number of bytes remaining in (struct fs). 

MAXBPG bounds the number of blocks of data per cylinder group, and is limited by the fact that 
cylinder groups are at most one block. The size of the free block table is derived from the size of 
blocks and the number of remaining bytes in the cylinder group structure (struct eg). 

Inode: The i-node is the focus of all file activity in the HP-UX file system. There is a unique i- 
node allocated for each active file, each current directory, each mounted-on file, text file, and the 
root. An i-node is ‘named’ by its device/i-number pair. For the format of an i-node and its 
flags, see inode(5) 

HARDWARE DEPENDENCIES 
Series 200: 

Series 200 HP-UX 5.0 release supports only one section per volume. Thus, there can only be one 
file system on each volume and the first 8 kbytes of a file system is the boot area. This area con¬ 
tains the LIF volume header, the directory that defines the contents of the volume and the 
bootstrapping program. 

HFS file structure is not implemented on Series 500 or Integral PC. 

SEE ALSO 

lif(l), HP-UX System Administrator’s Manual. 


Hewlett-Packard 


-4- 


July 10, 1985 



FS(5) 


Series 500 Implementation 


FS(5) 


NAME 

fs - format of system volume 
SYNOPSIS 

#include <sys/param.h> 

^include <sys/filsys.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Remarks: This manual page describes the format of the system volume as implemented on the 
Series 500. Refer to other fs manual pages for information valid for other implementa¬ 
tions. 

DESCRIPTION 

Every Structured Directory Format (SDF) volume is divided into logical blocks, the size of which 
is selected when init is executed. Block 0 is the superblock. It has the following format: 

struct filsys { 


ushort 

s_format; 

/* disc fmt, should = 0x700 Unix */ 

ushort 

s_corrupt; 

/* non-zero if directory corrupt */ 

char 

s_fname[16]; 

/* root dir name, blank padded ♦/ 

time_ios 

s_init; 

/* date initialized / unique id */ 

int 

s_blksz; 

/* no. bytes per block */ 

daddr_t 

s_boot; 

/* boot area starting block */ 

int 

s_bootsz; 

/♦ size of boot area in blks */ 

daddr_t 

s__fa; 

/♦ FA file starting block */ 

int 

s_version; 

/* version no., 0 for Unix */ 

daddr_t 

s_maxblk; 

/* largest addressable blk ♦/ 

char 

s_passwd[16]; 

/* volume password, Unix unused */ 

time__ios 

s_bkup; 

/* last backup date, Unix unused ♦/ 
/+ rest of blk unused ♦/ 


The file attributes file (FA file) begins at the block specified by s_/a in the superblock. It has five 
major sections: 
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Each entry consists of 128 bytes. Entry 0 is the i-node of the FA file itself (see inode{b) for a 
description of the i-node structure). Entry 1 is the i-node for the file system’s root directory, /. 

Entry 3 through entry n consists of the free map, which keeps track of every free (unused) block 
of memory on the device. The free map contains a bit for each block on the device. If a bit is set, 
the corresponding block of memory is free; otherwise, the corresponding block is being used. The 
free map is zero-padded to guarantee that it ends on a 128-byte boundary. 

Entry n+1 through the end of the FA file contains an entry for every file in the system. Each 
entry is either an i-node, an extent map, or unused. An extent map contains 128 bytes of infor¬ 
mation, and looks as follows: 

struct em_rec { 

ushort e_type; /* =2 for extent maps */ 

ushort e_exnum; /* # extents in this rec. ♦/ 

int e_resl; /* unused */ 

ino_t e_next; /* next map in list; none = neg */ 

ino_t e_last; /* last map in list; none = neg */ 

ino_t e_inode; /* owner i-node no. */ 

daddr_t e_boffset; /* blk offset of 1st extent from start of file */ 
struct { 

daddr_t e_startblk; /* extent start blk */ 

int e_numblk; /* # blks in extent */ 

} e_extent[13]; 

}; 

FILES 

/ usr/include/sys / param. h 
/usr/include/sys/filsys.h 
/ usr/include/sys / ino.h 

SEE ALSO 

inode(5), fsck(lM). 
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NAME 

fspec - format specification in text files 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

It is sometimes convenient to maintain text files on the HP-UX system with non-standard tabs, 
(i.e., tabs which are not set at every eighth column). Such files must generally be converted to a 
standard format, frequently by replacing all tabs with the appropriate number of spaces, before 
they can be processed by HP-UX system commands. A format specification occurring in the first 
line of a text file specifies how tabs are to be expanded in the remainder of the file. 

A format specification consists of a sequence of parameters separated by blanks and surrounded 
by the brackets <: and :>. Each parameter consists of a key letter, possibly followed immediately 
by a value. The following parameters are recognized: 

ttabs The t parameter specifies the tab settings for the file. The value of tabs must be one 
of the following: 

1. a list of column numbers separated by commas, indicating tabs set at the 
specified columns; 

2. a - followed immediately by an integer n, indicating tabs at intervals of n 
columns; 

3. a - followed by the name of a “canned” tab specification. 

Standard tabs are specified by t-8, or equivalently, tl,9,17,25,etc. The canned tabs 
which are recognized are defined by the tabs{l) command. 

ssize The s parameter specifies a maximum line size. The value of size must be an integer. 

Size checking is performed after tabs have been expanded, but before the margin is 
prepended. 

mmargin The m parameter specifies a number of spaces to be prepended to each line. The 
value of margin must be an integer. 

d The d parameter takes no value. Its presence indicates that the line containing the 

format specification is to be deleted from the converted file. 

e The e parameter takes no value. Its presence indicates that the current format is to 

prevail only until another format specification is encountered in the file. 

Default values, which are assumed for parameters not supplied, are t-8 and mO. If the s parame¬ 
ter is not specified, no size checking is performed. If the first line of a file does not contain a for¬ 
mat specification, the above defaults are assumed for the entire file. The following is an example 
of a line containing a format specification: 

* <:t5,10,15 s72:> * 

If a format specification can be disguised as a comment, it is not necessary to code the d parame¬ 
ter. 

Several HP-UX system commands have been specifically structured so they can correctly interpret 
file format specifications. 

HARDWARE DEPENDENCIES 
Series 500: 

Some earlier-design interface cards do not handle tab expansion correctly. This can cause 
unexpected results. 
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SEE ALSO 

ed(l), newform(l), tabs(l). 

BUGS 

Does not work with m(l) and ex{l). 
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NAME 

gettydefs - speed and terminal settings used by getty 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

The /etc/gettydefs file contains information used by getty(IM) to set up the speed and terminal 
settings for a line. It supplies information on what the login prompt should look like. It also sup¬ 
plies the speed to try next if the user indicates the current speed is not correct by typing a 
<break> character. 

Each entry in /etc/gettydefs has the following format: 

label# initial-flags # final-flags #login-prompt#next-label 

The pound sign (#) is the field separator for lines in gettydefs. The spaces must appear as 
shown. Each entry is followed by a blank line. Lines that begin with # are ignored and may be 
used to comment the file. The various fields can contain quoted characters of the form \b, \n, 
\c, etc., as well as \nnn, where nnn is the octal value of the desired character. The various fields 
are: 


label 


initial-flags 


final-flags 


login-prompt 


This is the string against which getty tries to match its second argument. It is 
often the speed, such as 1200, at which the terminal is supposed to run, but it 
need not be (see below). 

These flags are the initial ioctl[2) settings to which the terminal is to be set. The 
flags that getty imderstands are the same as the ones listed in 
/usr/include/termio.h (see tty{4)). Normally only the speed flag is required in the 
initial-flags. Getty automatically sets the terminal to raw input mode and takes 
care of most of the other flags. The initial-flag settings remain in effect until getty 
executes login{l). 

These flags take the same values as the initial-flags and are set just prior to when 
getty executes login. The speed flag is again required. The composite flag SANE 
takes care of most of the other flags that need to be set so that the processor and 
terminal are communicating in a rational fashion. The other two commonly 
specified final-flags are TAB3, so that tabs are sent to the terminal as spaces, and 
HUPCL, so that the line is hung up on the final close. 

This entire field is printed as the login-prompt. Unlike the above fields where 
white space is ignored (a space, tab or new-line), they are included in the login- 
prompt field. Thus, it is important that only the characters making up the login 
prompt be included between the #’s in this field, with no extra white space. 


next-label If this entry does not specify the desired speed, indicated by the user typing a 
<break> character, then getty searches for the entry with next-label as its label 
field and sets up the terminal for those settings. Usually, a series of speeds are 
linked together in this fashion, into a closed set: for instance, 2400 linked to 1200, 
which in turn is linked to 300, which finally is linked to 2400. 


If getty is called without a second argument, then the first entry of /etc/gettydefs is used, thus 
making the first entry of /etc/gettydefs the default entry. It is also used if getty cannot find the 
specified label. If /etc/gettydefs itself is missing, there is one entry built into the command 
which brings up a terminal at 300 baud. 


It is strongly recommended that /etc/gettydefs be run through getty with the check option to 
be sure there are no errors. 
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EXAMPLE 

The following two lines show an example of a 300/1200 baud toggle, which is useful for dial-up 
ports: 

1200# B1200 HUPCL # B1200 SANE IXANY IXANY TABS #login: #300 
300# B300 HUPCL # B300 SANE IXANY IXANY TABS #login: #1200 

The following line shows a typical 9600 baud entry for a hard-wired connection: 

9600# B9600 # B9600 SANE IXANY IXANY ECHOE TABS #login: #9600 

FILES 

/etc/gettydefs 
SEE ALSO 

login(l), ioctl(2), tty(4), getty(lM). 
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NAME 

group - group file, grp.h 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System III 

DESCRIPTION 

Group contains for each group the following information: 

group name 
encrypted password 
numerical group ID 

comma-separated list of all users allowed in the group 

This is an ASCII file. The fields are separated by colons; each group is separated from the next by 
a new-line. If the password field is null, no password is associated with the group. 

There are two files of this form in the system, /etc/group and /etc/logingroup. /etc/group exists 
to supply names for each group, and to support changing groups via newgrp{l). /etc/logingroup 
provides a default group access list for each user via login{l) and initgroups{Sc). 

The real and effective group ID set up by login for each user is defined in /etc/passwd (see 
passwd{b). If /etc/logingroup is empty or non-existent, the default group access list is limited to 
this effective group ID. If /etc/logingroup and /etc/group are links to the same file, the default 
access list includes the entire set of groups associated with the user. The group name and pass¬ 
word fields in /etc/logingroup are never used; they are included only to give the two files a uni¬ 
form format, allowing them to be linked together. 

All group id’s used in /etc/logingroup or /etc/passwd should be defined in /etc/group. No user 
should be associated with more than NGROUPS (see setgroups(2)) groups in /etc/logingroup. 

These files reside in directory /etc. Because of the encrypted passwords, they can and do have 
general read permission and can be used, for example, to map numerical group ID’s to names. 

Grp.h describes the group structure returned by getgrent(3), etc: 

struct group { /* see getgrent(3) */ 

char *gr_Jiame; 

char *gr_passwd; 

int gr_gid; 

char **gr_mem; 

}; 

FILES 

/etc/group /etc/logingroup 
SEE ALSO 

groups(l), newgrp(l), passwd(l), setgroups(2), crypt(3C), getgrent(3), initgroups(3c), passwd(5). 

BUGS 

There is no tool that helps you ensure that /etc/passwd, /etc/group, and /etc/logingroup are 
compatible. 

There is no tool that helps you set group passwords in /etc/group. 
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NAME 

inittab - script for the init process 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System V 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

The inittab file supplies the script to iniVs role as a general process dispatcher. The process that 
constitutes the majority of iniVs process dispatching activities is the line process /etc/getty that 
initiates individual terminal lines. Other processes typically dispatched by init are daemons and 
the shell. 

The inittab file is composed of entries that are position dependent and have the following format: 
id:rstate:action:process 

Each entry is delimited by a newline, however, a backslash (\) preceding a newline indicates a 
continuation of the entry. Up to 512 characters per entry are permitted. Comments may be 
inserted in the process field using the sh[l) convention for comments. Comments for lines that 
spawn gettys are displayed by the who{l) command. It is expected that they will contain some 
information about the line such as the location. There are no limits (other than maximum entry 
size) imposed on the number of entries within the inittab file. The entry fields are: 

id This is one or two characters used to uniquely identify an entry. 

rstate This defines the run-level in which this entry is to be processed. Run-levels effectively 
correspond to a configuration of processes in the system. That is, each process spawned 
by init is assigned a run-level or run-levels in which it is allowed to exist. The run- 
levels are represented by a number ranging from 0 through 6. As an example, if the 
system is in run-level 1, only those entries having a 1 in the rstate field will be pro¬ 
cessed. When init is requested to change run-levels, all processes which do not have an 
entry in the rstate field for the target run-level will be sent the warning signal 
(SIGTERM) and allowed a 20-second grace period before being forcibly terminated by a 
kill signal (SIGKILL). The rstate field can define multiple run-levels for a process by 
selecting more than one run-level in any combination from 0-6. If no run-level is 
specified, then the process is assumed to be valid at all run-levels 0-6. There are three 
other values, a, b and c, which can appear in the rstate field, even though they are not 
true run-levels. Entries which have these characters in the rstate field are processed 
only when the telinit (see weY(lM)) process requests them to be run (regardless of the 
current run-level of the system). They differ from run-levels in that init can never enter 
run-level a, b or c. Also, a request for the execution of any of these processes does not 
change the current run-level. Furthermore, a process started by an a, b or c command 
is not killed when init changes levels. They are only killed if their line in /etc/inittab 
is marked off in the action field, their line is deleted entirely from /etc/inittab, or init 
goes into the SINGLE USER state. 

action Key words in this field tell init how to treat the process specified in the process field. 
The actions recognized by init are as follows: 

respawn If the process does not exist then start the process, do not wait for its ter¬ 
mination (continue scanning the inittab file), and when it dies restart the 
process. If the process currently exists then do nothing and continue scan¬ 
ning the inittab file. 

wait Upon inifs entering the run-level that matches the entry’s rstate, start 

the process and wait for its termination. All subsequent reads of the init¬ 
tab file while init is in the same run-level will cause init to ignore this 


He wlett-P ackard 


- 1 - 


July 9, 1985 


INITTAB(5) 


INITTAB(5) 


entry. 

Upon iniVs entering a run-level that matches the entry’s rstate, start the 
process, do not wait for its termination. When it dies, do not restart the 
process. If upon entering a new run-level^ where the process is still run¬ 
ning from a previous run-level change, the program will not be restarted. 

The entry is to be processed only at iniVs boot-time read of the inittab 
file. Init is to start the process, not wait for its termination; and when it 
dies, not restart the process. In order for this instruction to be meaning¬ 
ful, the rstate should be the default or it must match inWs run-level at 
boot time. This action is useful for an initialization function following a 
hardware reboot of the system. 

The entry is to be processed only at iniVs boot-time read of the inittab 
file. Init is to start the process, wait for its termination and, when it dies, 
not restart the process. 

Execute the process associated with this entry only when init receives a 
power fail signal (SIGPWR see signal(2)). 

Execute the process associated with this entry only when init receives a 
power fail signal (SIGPWR) and wait until it terminates before continuing 
any processing of inittab. 

If the process associated with this entry is currently running, send the 
warning signal (SIGTERM) and wait 20 seconds before forcibly terminat¬ 
ing the process via the kill signal (SIGKILL). If the process is nonex¬ 
istent, ignore the entry. 

This instruction is really a synonym for the respawn action. It is func¬ 
tionally identical to respawn but is given a different keyword in order to 
divorce its association with run-levels. This is used only with the a, b or 
c values described in the rstate field. 

initdefault An entry with this action is only scanned when init initially invoked. Init 
uses this entry, if it exists, to determine which run-level to enter initially. 
It does this by taking the highest run-level specified in the rstate field 
and using that as its initial state. If the rstate field is empty, this is inter¬ 
preted as 0123456 and so init will enter run-level 6. Additionally, if init 
does not find an initdefault entry in /etc/inittab, then it will request 
an initial run-level from the user at reboot time. 

sysinit Entries of this type are executed before init tries to access the console. It 
is expected that this entry will be only used to initialize devices on which 
init might try to ask the run-level question. These entries are executed 
and waited for before continuing. 

process This is a sh command to be executed. The entire process field is prefixed with exec and 
passed to a forked sh as sh -c /exec commandf. For this reason, any legal sh syntax can 
appear in the process field. Comments can be inserted with the ; i^comment syntax. 

FILES 

/etc/inittab 

SEE ALSO 

sh(l), who(l), getty(lM), init(lM), exec(2), open(2)), signal(2). 


once 

boot 
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powerfail 

powerwait 
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NAME 

inode - format of an i-node 
SYNOPSIS 

^include <sys/types.h> 

^include ,sys/inode.h> 

^include <sys/ino.h> 

HP-UX COMPATIBILITY 

Level: Large Machine/HP Extension/HFS 

Origin: HFS 

Remarks: This entry describes the i-node structure for the HFS file system. Refer to other 
inode{5) manual pages for information valid for other implementations. 

DESCRIPTION 

An i-node for a plain file or directory in a file system has the following structure defined by 
<sys/ino.h> and <sys/inode.h>. 

/* Inode structure as it appears on a disk block */ 
struct dinode 
{ 


u_short 

di_mode; 

/* mode and type of file */ 

short 

di_nlink; 

/♦ number of links to file ♦/ 

short 

di_uid; 

/* owner’s user id */ 

short 

di_gid; 

/* owner’s group id */ 

quad 

di_size; 

/ * number of bytes in file * / 

time_t 

di_atime; 

/* time last accessed */ 

long 

di_atspare; 


time_t 

di_mtime; 

/* time last modified */ 

long 

di_mtspare; 

time_t 

di_ctime; 

/* time of last file status change */ 

long 

di_ctspare; 


daddr_t 

di_db[NDADDR]; /* disk block addresses */ 

daddr_t 

di_ib[NIADDR]; 

/* indirect blocks */ 

long 

di_flags; 

/* status, currently unused */ 

long 

di_blocks; 

/* blocks actually held */ 

long 

di_spare[5]; 

/* reserved, currently unused */ 


}; 

For the meaning of the defined types ushort, quad, daddr—t and time—t see types{7). 

See /usr/include/sys/inode.h for the definition of i-node structures for special files, pipes, or 
FIFO’s. 

FILES 

/usr/include/sys/ino.h 

SEE ALSO 

stat(2), fs(5), types(7). 
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NAME 

inode - format of an i-node 
SYNOPSIS 

^include <sys/types.h> 

#include <sys/param.h> 

#include <sys/ino.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Remarks: This entry describes the i-node structure for the Series 500. Refer to other inode 
manual pages for information valid for other implementations. 

DESCRIPTION 

An i-node for an ordinary file or directory in a file system has the following structure, as defined 
in sys/ino.h: 

I* 

* I-node structure as it appears on disc. This i-node is actually 

* a file information record (FIR) in the HP SDF disc format. 

*! 


struct dinode { 
ushort 

di_type 

/* =1 for inodes */ 

ushort 

di_ftype; 

/* file type */ 

ushort 

di_count; 

/* reference count */ 

short 

di_uftype; 

/* user file type (LIF) */ 

time_ios 

di_ctime; 

/* time created */ 

unsigned 

di_other; 

/* public capabilities */ 

ino_t 

di_protect; 

/♦ file protect rec. none=-l */ 

ino_t 

di__label; 

/* file label rec. none=-l */ 

int 

di_blksz; 

/* file size in blocks */ 

int 

di_max; 

* largest byte writable */ 

ushort 

di_exsz; 

/* recom. extent size ♦/ 

ushort 

di_exnum; 

/* no. i-node extents (1-4) */ 

struct { 

daddr_t 

di_startblk;/* extent start blk */ 


int 

di_numblk;/* no. blks in extent */ 

} di_extent[4]; 

ino_t 

di_exmap; 

/♦ inode 1st extent map */ 

int 

di_size; 

/* none = -1 */ 

/* current size, bytes */ 

/* Warning! Next 2 fields apply only to directories */ 

ino_t 

di_parent; 

/ * inode of parent ♦ / 

char 

di_name[16]; 

/* name of this directory ♦/ 

/♦ The remaining fields defined only for local */ 

/* implementation of structured directory format. */ 

time_t 

di_atime; 

/* time last accessed */ 

time_ios 

di_mtime; 

/* time last mod. */ 

int 

di_recsz; 

/* logical record size */ 

ushort 

di_uid; 

/* owner’s user id */ 

ushort 

di_gid; 

/* owner’s group id */ 

ushort 

di_mode; 

/* mode, type of file */ 
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char di_res2[2]; /* unused */ 

/* The next field used only if file is =*=/ 

/* a device file; otherwise it is zero */ 

dev_t di_dev; /* description of device ♦/ 

}; 

The meaning of the type declarations included above can be found in types{7). 

FILES 

/usr / include/sys/ino.h 

SEE ALSO 

dir(5), fs(5), types(7). 
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NAME 

issue - issue identification file 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

The file /etc/issue contains the issue or project identification to be printed as a login prompt. 
This is an ASCII file which is read by program getty and then written to any terminal spawned or 
respawned from the lines file. 

FILES 

/etc/issue 

SEE ALSO 

getti(lm), login(l). 


Hewlett-Packard 


- 1 - 


July 9, 1985 



LIF(5) 


LIF(5) 


NAME 

LIF - Logical Interchange Format description 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: HP 

DESCRIPTION 

LIF (Logical Interchange Format) is a Hewlett-Packard standard disc format that may be used 
for interchange of files among various HP computer systems. A LIF volume contains a header 
(identifying it as a LIF volume) and a directory that defines the contents (i.e. files) of the volume. 
The size of the directory is fixed when the volume is initialized (see and sets an upper 

bound on the number of files that may be created on the volume. 

HP-UX contains a set of utilities (referred to hereafter as /^/*(l)) that may be used to initialize a 
LIF volume (i.e. create a header and an empty directory), copy files to and from LIF volumes, list 
the contents of LIF volumes, remove LIF files, and rename LIF files. 

The utilities are the only utilities within HP-UX where the internal structure of a LIF 

volume is known. To the rest of HP-UX a LIF volume is simply a file containing some unspecified 
data. The term ‘LIF volume’ should in no way be confused with the HP-UX notion of a file sys¬ 
tem volume or mountable volume. 

The LIF utility on HP-UX currently supports three file types, ASCII(l), BINARY(-2) and 
BIN(-23951). 

There are three copying modes associated with them. 

ASCII If the copying mode is ASCII, and an HP-UX file is being copied to a LIF volume, the 
utility strips the trailing LF and prepends two bytes of record length to each record. 
These records are then written to a LIF formated media. When copying a LIF ASCII 
file to HP-UX the two byte record length are stripped and a trailing LF is appended. 
These records are then written to the destination. In this mode of copying the length of 
the file is preserved. The default file type for this mode of copying is ASCII(l). 

BINARY 

If the copying mode is BINARY, and an HP-UX file is being copied to a LIF volume, 
the utility simply appends two bytes for record length to each Ik byte record. A trailing 
fractional block will have a count reflecting the number of bytes in that block. No 
interpretation is placed on the content of the records. These records are then written to 
a LIF formated media. When copying a LIF file to an HP-UX file in BINARY copying 
mode, the record lengths are stripped and the content of records is directly written to 
the destination. In this mode of copying the length of the binary file is preserved. The 
default file type for this mode of copying is BINARY(-2). 

RAW If the copying mode is RAW, and an HP-UX file is being copied to a LIF volume, the 
utility simply copies the raw data to the destination. File sizes which are not multiples 
of 256 bytes will be padded with nulls to the next higher multiple. Therefore, the file 
sizes are not preserved. When copying a LIF file to an HP-UX file in RAW mode, the 
information is directly copied without any interpretation placed on the content of the 
source. The default file type for this mode of copying is BIN(-23951). 

A LIF volume may be created on any HP-UX file (either regular disc file or device special file) 
that supports random access via lseek{2). Note that you should not mount the special file before 
using the routines. See lifinit{l) for details. Within a LIF volume, individual files are 

identified by 1 to 10 character file names. File names may consist of upper-case alphanumeric 
characters (A through Z, 0 through 9) and the underscore character (_). The first character of a 
LIF file name must be a letter. The utilities will accept any file name, including illegal file 

names generated on other systems, but will only create legal names. For example, file names 
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containing lower-case letters will be read but not created. 

LIF file names are specified to the utilities by concatenating the HP-UX path name for the 

LIF volume with the LIF file name, separating the two with a colon (:). For example, 

/dev/fd.O:ABC specifies LIF file ABC within HP-UX device special file /dev/fd.O. 

myfile:ABC specifies LIF file ABC within HP-UX disc file ‘myfile’. 

Note that this file naming convention is applicable only for use as arguments to the utilities 

and do not constitute legal path names for any other use within HP-UX. 

HARDWARE DEPENDENCIES 
Series 500: 

You must use a character special file to access the media. 

SEE ALSO 

lifcp(l), lifinit(l), lifls(l), lifrename(l), lifrm(l). 
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NAME 

magic - magic numbers for HP-UX implementations 
SYNOPSIS 

^include <magic.h> 

HP-UX COMPATIBILITY 

Level: Use: HP-UX/RUN ONLY 

Header: HP-UX/DEVELOPMENT 

Origin: HP 

DESCRIPTION 

Magic.h localizes all information about HP-UX "magic numbers" in one file, and thus facilitates 
uniform treatment of magic numbers. This file specifies the location of the magic number in a file 
(always the start of the file) and the structure of the magic number: 

struct magic_number 

{ 

unsigned short system_id; 

unsigned short file_type; 

}; 

typedef struct magic_number MAGIC; 

Magic.h includes definitions for the system IDs of all HP machines running HP-UX, and file types 
that are common to all implementations. There may be additional implementation-dependent file 
types. The predefined file types are: 

/* for object code files */ 

#define RELOC_MAGIC 0x106 /* relocatable only */ 

^define EXEC_MAGIC 0x107 /* normal executable */ 

#define SHARE_MAGIC 0x108 /* shared executable */ 

HARDWARE DEPENDENCIES 

Series 200: 

The following additional file type is defined: 

#define DEMAND_MAGIC OxlOB 

SEE ALSO 

ar(l), chatr(l), ld(l), a.out(5), ar(5), model(5). 

BUGS 

Cpio files use a different form of magic number that is incompatible with magic{6). 
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NAME 

master - master device information table 

HP-UX COMPATIBILITY 

Level: Config(lM) Support — HP-UX/RUN ONLY 

Origin: System V and HP 

DESCRIPTION 

This file is used by config(lM) to obtain device information that enables it to generate the 
configuration file. Master contains lines of various Master contains lines of various forms rame- 
ters. 

Software drivers are defined as follows: 

Field 1: device name, used in the user-specified dfile (8 chars maximum) 

Field 2: handler name, used by the kernel to prefix routines such as cs80_read, lp_write, ... 

Field 3: element characteristics: 5 bits make up the mask 
Bit 1 - card 

Bit 2 - specified only once 
Bit 3 - required driver 
Bit 4 - block device 
Bit 5 - character device 

Field 4: functions for the device: 10 bits make up the mask 
Bit 1 - size handler 
Bit 2 - link routine 
Bit 3 - open handler 
Bit 4 - close handler 
Bit 5 - read handler 
Bit 6 - write handler 
Bit 7 - ioctl handler 
Bit 8 - select handler 
Bit 9 - seltru handler 
Bit 10 - C_ALLCLOSES flag 

Field 5: major device number, if a block-type device 
Field 6: major device number, if a character-type device 
Aliases for names are defined as follows: 

Field 1: alias name => product number 

Field 2: device name 

Parameters are defined as follows: 

Field 1: parameter name, as used in the user-specified 
dfile 

Field 2: parameter name, as used in the #define statement 
in conf.c 

Field 3: parameter value 

SEE ALSO 

config(lM) 
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NAME 

mknod - create a special file entry 
SYNOPSIS 

#include <mknod.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

DESCRIPTION 

Mknod.h provides utilities to pack and unpack device names as used by mknod(2). It contains 
the macro dev = makedev(major, minor) which packs the major and minor fields into a form 
suitable for mknod{2). It also contains major (dev) and minor (dev) which extract the 
corresponding fields. 

The macro MINOR_FORMAT is a print/ specification that prints the minor field in the format 

best suited to the particular implementation. The specification given by MINOR_FORMAT must 

cause the resulting string to indicate the base of the number in the same format as that used for 
C: no leading zero for decimal, leading zero for octal, and leading zero and ’x’ for hexadecimal. 

When a minor field is printed in the format specified by MINOR-FORMAT, each sub-field con¬ 
tained in the minor will be wholly contained in the mininum possible number of digits of the 
resulting string. (Splitting a field across unnecessary digits for the sake of packing is not done.) 

SEE ALSO 

mknod(lM), mknod(2), section 4. 

WARNING 

All of the macros defined in <mknod.h> are also defined in <sys/sysmacros.h> for Bell System V 
compatibility. Mknod.h only exists for compatibility with previous releases of HP-UX, and should 
not be used for new development. 
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NAME 

mnttab - mounted file system table 
SYNOPSIS 

#include <sys/types.h> 

#include <mnttab.h> 

HP-UX COMPATIBILITY 

Level: Large Machine/SVID 

Origin: System V 

DESCRIPTION 

Mnttab resides in directory /etc and contains a table of devices, mounted by the mount{lM) 
command, in the following structure as defined by <mnttab.h>: 

struct mnttab { 

char mt_dev[MNTLEN]; 

char mt_filsys[MNTLEN]; 
short mt_ro_flg; 
time_t mt_time; 

}; 

Each entry is (2 x MNTLEN + 6) bytes in length (MNTLEN is defined in /usr/include/mnttab.h). 
The first MNTLEN bytes are the null-padded name of the place where the special file is mounted; 
the next MNTLEN bytes represent the null-padded root name of the mounted special file; the 
remaining 6 bytes contain the mounted special file's read/write permissions and the date on 
which it was mounted. The minimum value for MNTLEN is 32. 

The maximum number of entries in mnttab is based on the system parameter NMOUNT located 
in /usr/include/mnttab.h, which defines the number of allowable mounted special files. 

WARNING 

The table is present only for programs to return information about the mounted file systems. It 
does not matter to mount if there are duplicated entries nor to amount if a name cannot be 
found. 

SEE ALSO 

mount(IM), setmnt(lM). 
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NAME 

model - HP-UX machine identification 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin; HP 

SYNOPSIS 

#mclude <model.h> 

DESCRIPTION 

There are some distinctions between the implementations of HP-UX due to hardware differences. 
Where such distinctions exist, conditional compilation or other definitions can be used to isolate 
the differences. Flags and typedefs to resolve these distinctions are collected in model.h. This file 
contains constants indentifying various HP-UX implementations. 

For example, the header file model.h contains the constants HP_S_200 for Series 200 and 
HP_S_500 for Series 500. Other such constants will be added as HP-UX extends to other 
machines. 

Model.h also has a statement defining the preprocessor constant MYSYS to represent the specific 
implementation for which compilation is desired. MYSYS will be equal to one of the constants 
above (HP_S_200 or HP_S_500). 

Conditional compilation may be used to adapt one file for execution on more than one HP-UX 
implementation, if it contains implementation- or architecture-dependent features. For instance, 

#if MYSYS==HP_S_200 
<statements> 

#endif 

will cause the statements following the if statement to be compiled only for the HP 9000 Series 

200 . 

Model.h also contains typedefs for several predefined types to enhance portability of certain types 
of code and of files. 

intS 

u_int8 

Signed and unsigned 8-bit integers. 

intl6 

u_intl6 

Signed and unsigned 16-bit integers. 

int32 
u_int32 

Signed and unsigned 32-bit integers. 

machptr 

u__machptr 

Signed and unsigned integers large enough to hold a pointer. 

HARDWARE DEPENDENCIES 
Series 200: 

A conditional compilation variable, hp9000s200, is implemented. It is predefined to the C 
preprocessor. 

Series 500: 

A conditional compilation variable, hp9000s500, is implemented. It is predefined to the C 
preprocessor. 

SEE ALSO 

cc(l), cpp(l), magic(5). 
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NAME 

nlist - nlist structure format 
SYNOPSIS 

#include <nlist.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System III 

Remarks: The exact content of the structure defined below can be best found by examining 
/usr/include/nlist.h. It varies somewhat between the various implementations of HP- 
UX. 

Nlist is currently implemented on the Series 200 and Integral PC only. 

DESCRIPTION 

Nlist can be used to extract information from a the symbol table in an object file. Because 
symbol tables are machine dependent (as defined in each implementation’s copy of <a.out.h>) a 
header file, nlist.h is defined to encapsulate the differences. 

The nlist function, when used with the nlist structure can be used to extract certain information 
about selected symbols in the symbol table. The data associated with each symbol is machine 
specific, thus only the name and position of the n—name field in the nlist structure is standardized 
by HP-UX. The rest of the structure includes at least the value and type of the symbol. The 
names and meanings of all fields not standardized will change no more than necessary. 

The structure, as defined for the Series 200, is: 
struct nlist { 


char 

*n_name; 

long 

n_value; 

unsigned char 

n_type; 

unsigned char 

n_length; 

short 

n_almod; 

short 

n_unused; 


}; 

SEE ALSO 

nlist (3), a.out (5) 


Hewlett-Packard 


- 1 - 


July 10, 1985 



PASSWD(5) 


PASSWD(5) 


NAME 

passwd - password file, pwd.h 

HP-UX COMPATIBILITY 

Level: Multi-user - HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Passwd contains for each user the following information: 

login name 
encrypted password 
numerical user ID 
numerical group ID 

reserved field which will be used for identification 
initial working directory 
program to use as shell 

This is an ASCII file. Each field within each user’s entry is separated from the next by a colon. 
Each user is separated from the next by a new-line. If the password field is null, no password is 
demanded. If the shell field is null, /bin/sh is used. 

This file resides in directory /etc. Because of the encrypted passwords, it can and does have gen¬ 
eral read permission and can be used, for example, to map numerical user IDs to names. 

The encrypted password consists of 13 characters chosen from a 64-character set of "digits" 
described below, except when the password is null, in which case the encrypted password is also 
null. Login can be prevented by entering in the password field a character that is not part of the 
set of digits(e.g. *). 

The characters used to represent "digits" are . for 0, / for 1, 0 through 9 for 2-11, A through Z 
for 12-37, and a through z for 38-63. 

The super-user can set up "password aging" for a user by inserting a comma and a string of char¬ 
acters after the user’s encrypted password. The first character in the string is the maximum 
number of weeks a password can remain valid; after that number of weeks elapses, the user will be 
required to choose a new password upon logging in. The second character is the minimum 
number of weeks that must elapse before the user can change passwords again. The rest of the 
characters tell in which week the password was last changed (weeks are counted from the begin¬ 
ning of 1970). A null string is the same as zero. If both the first and second characters are zero 
(i.e. both "."), the user must change passwords upon his or her next login; the "age" will then 
disappear from the password file altogether. For example, if the super-user inserts after a 
user’s encrypted password, the user will have to change passwords upon logging in; when that 
happens, the will disappear. The comma is required. 

If the second character has a greater decimal equivalent than the first (such as only the 

super-user will be able to change the password. 

Pwd.h designates the broken out password file as obtained by getpwent(3C): 
struct passwd { 


char 

*pw_name; 

char 

*pw_passwd; 

unsigned int 

*pw_uid; 

unsigned int 

*pw_gid; 

char 

*pw_age; 

char 

*pw_comment; 

char 

*pw_gecos; 

char 

*pw_dir; 

char 

*pw_shell; 
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}; 

It is suggested that the range 0-99 not be used for user and group ID’s {pw-^uid and pw—gid in 
the above structure) so that IDs which may be assigned for system software do not conflict. 

HARDWARE DEPENDENCIES 

Series 200/500: 

The following flelds have character limitations as noted: 

the login name fleld can be no longer than 8 characters; 

the initial working directory fleld can be no longer than 63 characters; 

the program fleld can be no longer than 44 characters. 

The results are unpredictable if these fields are longer than the limits specified above. 

The reserved field, called pw—gcos in the data structures used by getpwent{3C), is reserved 
for future use. It currently may be used to contain any information the system manager 
desires, but such use may conflict with the use of future HP features. The correct operation 
of the system will never depend on this field, but some optional feature may specify its for¬ 
mat and content. 

FILES 

/etc/passwd 
SEE ALSO 

login(l), passwd(l), a641(3C), crypt(3C), getpwent(3C), group(5). 


Hewlett-Packard 


-2- 


July 9, 1985 



PRIVGRP(5) 


Series 200/300 Only 


PRIVGRP(5) 


NAME 

privgrp - format of privileged values 
SYNOPSIS 

^include <sys/privgrp.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 
Remarks: 

Implemented on Series 200/300 only. 

DESCRIPTION 

Setprivgrp(2) sets a mask of privileges, and Getprivgrp{2) returns an array of structures giving 
privileged group assignments on a per group-id basis. Privgrp.h contains the constants and struc¬ 
tures needed to deal with these system calls, and contains: 

/* 

* Privileged group definitions - 

* the numeric values may vary between implementations. 

*/ 

#define PRIV^TPRIO 1 
#define PRIV^LOCK 2 
#define PRIV_CHOWN 3 

/* Maximum number of privileged groups in system */ 

#define PRIV-MAXGRPS 32 

/* 

* Size of the privilege mask, 

* based on largest numbered privilege 

V 

#define PRIV-MASKSIZ 1 

r 

* Structure defining the privilege mask 

7 

struct privgrp_map { 
int priv_groupno; 

unsigned int priv_mask[PRIV__MASKSIZ]; 

}; 

/* 

* Structure returned to user on getprivgrp system call. 

7 

struct privgrp_list { 

struct privgrp_map[PRIV_MAXGRPS-|-l]; 

}; 

PRIV—RTPRIO allows access to the rtprio{2) system call. 

PRIV__MLOCK allows access to the plock{2) system call. 

PRIV—CHOWN allows users to give files away. 
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Privileges are described in a multi-word mask. The value of the #define for each privilege is 
interpreted as a bit index (counting from 1). Thus a group-id may have several different 
privileges assocaited with it by having different bits or’ed into the mask. 

The system is configured with a maximun number of groups with special privileges. 
PRIV—MAXGRPS defines this maximum. 

PRIV—MASKSIZ defines the size of the multi-word mask used defining privileges associated with 
a group-id. 

Privileges are returned to the user from the getprivgrp{2) system call in array of structures of type 
struct privgrp_mask. The structure associates a multi-word mask with a group-id. 

SEE ALSO 

getprivgrp(2) 
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NAME 

profile - set up user’s environment at login time 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

If the file /etc/profile exists, it is executed by the shell for every user who logs in. /etc/profile 
should be set up to do only those things that are desirable for every user on the system, or to set 
reasonable defaults. If your login (home) directory contains a file named .profile, it will be exe¬ 
cuted before your session begins. Profile files are useful for setting various environment parame¬ 
ters, setting terminal modes, or overriding some or all of the results of executing /etc/profile. 

The following example is typical (except for the comments): 

# Make some environment variables global 
export MAIL PATH TERM 

^ Set file creation mask 
umask 22 

# Tell me when new mail comes in 
M AIL=/usr / mail/my name 

# Add my /bin directory to the shell search sequence 
PATH=$PATH:$HOME/bin 


FILES 

$HOME/.profile 

/etc/profile 

SEE ALSO 

env(l), login(l), mail(l), sh(l), stty(l), su(l), environ(7), term(7). 
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NAME 

ranlib - archive symbol table format for object libraries 
SYNOPSIS 

#include <ranlib.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

DESCRIPTION 

Any archive containing object files also includes an archive symbol table, thus allowing the linker 
Id to scan libraries in random (rather than sequential) order. 

The archive symbol table (if it exists) is always the first file in the archive, but it is never listed. 
It is automatically created and/or updated by ar. 

The archive symbol table lists each externally known name in the archive, together with the offset 
of the archive element that defines that name. This offset is useful as an input argument to 
lseek{2) or fseek{3). 

HARDWARE DEPENDENCIES 

Series 500: 

The archive symbol table file contains the symbol table and a name pool of strings (the 
names of external symbols). This allows for symbols with arbitrarily long names. The 
rl_hdr structure defines the layout of the file, and the rl_ref structure defines the con¬ 
tents of an archive symbol table entry. These structures have the following format: 

struct rl_hdr { 

long int rl_tcbas; 
long int rl_tclen; 
long int rl_nmbas; 
long int rl_nmlen; 

}; 

struct rl_ref { 

long int name_pos; 
long int lib_pos; 

}; 

Series 200: 

The archive symbol table file contains a header, a name pool of strings (the names of 
external symbols), and the archive symbol table. This allows for symbols with arbitrarily 
long names. The header contains a short integer which specifies the number of entries, 
and a long integer which specifies the size of the string table. Following this is the name 
pool. The last section of the file contains the archive symbol table entries. The structure 
of these entries is defined below: 

typedef long off_t; 

struct ranlib { 

union { 

ofL_t ran_strx; /* string table index */ 

char *ran_name; 

} ran_un; 

off_t ran_off; /* lib member offset */ 

}; 
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/* index into name pool */ 
/* offset of defining file */ 


/* offset of table */ 

/* length of table */ 

/* offset of name pool */ 
/* length of name pool */ 
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SEE ALSO 

ar(l), ld(l), ar(5). 
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NAME 

sccsfile - format of SCCS file 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

An SCCS file is an ASCII file. It consists of six logical parts: the checksum^ the delta table (con¬ 
tains information about each delta), user names (contains login names and/or munerical group 
IDs of users who may add deltas), flags (contains definitions of internal keywords), comments 
(contains arbitrary descriptive information about the file), and the body (contains the actual text 
lines intermixed with control lines). 

Throughout an SCCS file there are lines which begin with the ASCII SOH (start of heading) char¬ 
acter (octal 001). This character is hereafter referred to as the control character and will be 
represented graphically as @. Any line described below which is not depicted as beginning with 
the control character is prevented from beginning with the control character. 

Entries of the form DDDDD represent a five digit string (a number between 00000 and 99999). 
Each logical part of an SCCS file is described in detail below. 

Checksum 

The checksum is the first line of an SCCS file. The form of the line is: 

@hDDDDD 

The value of the checksum is the sum of all characters, except those of the first line. The 
@h provides a magic number of (octal) 000550 (0168 hex). 

Delta table 

The delta table consists of a variable number of entries of the form: 

@s DDDDD/DDDDD/DDDDD 

@d <type> <SCCS ID> yr/mo/da hr:mi:se <pgmr> DDDDD DDDDD 
m DDDDD ... 

@x DDDDD ... 

@g DDDDD ... 

@m <MR number> 


@c <comments> ... 


The first line (@s) contains the number of lines inserted/deleted/unchanged respectively. 
The second line (@d) contains the type of the delta (currently, normal: D, and removed: 
R), the SCCS ID of the delta, the date and time of creation of the delta, the login name 
corresponding to the real user ID at the time the delta was created, and the serial 
numbers of the delta and its predecessor, respectively. 

The @i, @x, and @g lines contain the serial numbers of deltas included, excluded, and 
ignored, respectively. These lines are optional. 

The @m lines (optional) each contain one MR number associated with the delta; the @c 
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lines contain comments associated with the delta. 

The @e line ends the delta table entry. 

User names 

The list of login names and/or numerical group IDs of users who may add deltas to the 
file, separated by new-lines. The lines containing these login names and/or numerical 
group IDs are surrounded by the bracketing lines @u and @U. An empty list allows any¬ 
one to make a delta. 

Flags 

Keywords used internally (see admin{l) for more information on their use). Each flag 
line takes the form: 

@f <flag> <optional text> 

The following flags are deflned: 

@f t <type of program> 

@f V <program name> 

@f i 
@fb 

@f m <module name> 

@f f <floor> 

@f c <ceiling> 

@f d <default-sid> 

@f n 

@fj 

@f 1 <lock-releases> 

@f q <user deflned> 


The t flag deflnes the replacement for the %Y% identiflcation keyword. The v flag con¬ 
trols prompting for MR numbers in addition to comments; if the optional text is present 
it defines an MR number validity checking program. The i flag controls the 
warning/error aspect of the “No id keywords” message. When the i flag is not present, 
this message is only a warning; when the i flag is present, this message will cause a 
“fatal” error (the file will not be gotten, or the delta will not be made). When the b flag 
is present the -b key letter may be used on the get command to cause a branch in the 
delta tree. The m flag defines the first choice for the replacement text of the %M% 
identification keyword. The f flag defines the “floor” release; the release below which no 
deltas may be added. The c flag deflnes the “ceiling” release; the release above which no 
deltas may be added. The d flag deflnes the default SID to be used when none is specified 
on a get command. The n flag causes delta to insert a “null” delta (a delta that applies 
no changes) in those releases that are skipped when a delta is made in a new release (e.g., 
when delta 5.1 is made after delta 2.7, releases 3 and 4 are skipped). The absence of the 
n flag causes skipped releases to be completely empty. The j flag causes get to allow con¬ 
current edits of the same base SID. The 1 flag defines a list of releases that are locked 
against editing {get{l) with the -e keyletter). The q flag defines the replacement for the 
%Q% identification keyword. 

Comments 

Arbitrary text surrounded by the bracketing lines @t and @T. The comments section 
typically will contain a description of the file’s purpose. 

Body 

The body consists of text lines and control lines. Text lines don’t begin with the control 
character, control lines do. There are three kinds of control lines: insertCdelete, and 
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end, represented by: 

@I DDDDD 
@D DDDDD 
@E DDDDD 

respectively. The digit string is the serial number corresponding to the delta for the con¬ 
trol line. 


SEE ALSO 

admin(l), delta(l), get(l), prs(l). 

sees User’s Guide in HP-UX Concepts and Tutorials. 
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NAME 

term - format of compiled term file. 

SYNOPSIS 

term 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Compiled terminfo descriptions are placed under the directory /usr/lib/terminfo. In order to 
avoid a linear search of a huge HP-UX system directory, a two-level scheme is used: 
/usr/lib/terminfo/c/name where name is the name of the terminal, and c is the first character 
of name. Thus, act4 can be found in the file /usr/lib/terminfo/a/act4. Synonyms for the 
same terminal are implemented by multiple links to the same compiled file. 

The format has been chosen so that it will be the same on all hardware. An 8 or more bit byte is 
assumed, but no assumptions about byte ordering or sign extension are made. 

The compiled file is created with the program, and read by the routine setupterm. Both 

of these pieces of software are part of curses{ZX). The file is divided into six parts: the header, 
terminal names, boolean flags, numbers, strings, and string table. 

The header section begins the file. This section contains six short integers in the format described 
below. These integers are (1) the magic number (octal 0432); (2) the size, in bytes, of the names 
section; (3) the number of bytes in the boolean section; (4) the number of short integers in the 
numbers section; (5) the number of offsets (short integers) in the strings section; (6) the size, in 
bytes, of the string table. 

Short integers are stored in two 8-bit bytes. The first byte contains the least significant 8 bits of 
the value, and the second byte contains the most significant 8 bits. (Thus, the value represented 
is 256*second+first.) The value -1 is represented by 0377, 0377, other negative value are illegal. 
The -1 generally means that a capability is missing from this terminal. Machines where this does 
not correspond to the hardware read the integers as two bytes and compute the result. 

The terminal names section comes next. It contains the first line of the terminfo description, list¬ 
ing the various names for the terminal, separated by the ‘ I ’ character. The section is terminated 
with an ASCII NUL character. 

The boolean fiags have one byte for each flag. This byte is either 0 or 1 as the flag is present or 
absent. The capabilities are in the same order as the file <term.h>. 

Between the boolean section and the number section, a null byte will be inserted, if necessary, to 
ensure that the number section begins on an even byte. All short integers are aligned on a short 
word boundary. 

The numbers section is similar to the flags section. Each capability takes up two bytes, and is 
stored as a short integer. If the value represented is -1, the capability is taken to be missing. 

The strings section is also similar. Each capability is stored as a short integer, in the format 
above. A value of -1 means the capability is missing. Otherwise, the value is taken as an offset 
from the beginning of the string table. Special characters in "X or \c notation are stored in their 
interpreted form, not the printing representation. Padding information $<nn> and parameter 
information %x are stored intact in uninterpreted form. 

The final section is the string table. It contains all the values of string capabilities referenced in 
the string section. Each string is null terminated. 

Note that it is possible for setupterm to expect a different set of capabilities than are actually 
present in the file. Either the database may have been updated since setupterm has been recom¬ 
piled (resulting in extra unrecognized entries in the file) or the program may have been recompiled 
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more recently than the database was updated (resulting in missing entries). The routine setup- 
term must be prepared for both possibilities - this is why the numbers and sizes are included. 
Also, new capabilities must always be added at the end of the lists of boolean, number, and string 
capabilities. 

As an example, an octal dump of the description for the Microterm ACT 4 is included: 

microterm I act41 microterm act iv, 

cr="M, cudl='J, ind="J, bel="G, am, cubl="H, 
ed="_, el="", clear="L, cup='T%pl%c%p2%c, 
cols#80, lines#24, cufl="X, cuul="Z, home="]. 


000 

032 

001 


\o 

025 

\o 

\b 

\o 

212 

\o 

" 

\o 

m 

i 

c 

r 

020 

0 

t 

e 

r 

m 

1 

a 

c 

t 

4 

1 

m 

i 

c 

r 

0 

040 

t 

e 

r 

m 


a 

c 

t 


i 

V 

\o 

\o 

001 

\o 

\o 

060 

\o 

\o 

\o 

\o 

\o 

\o 

\0 

\o 

\o 

\o 

\o 

\o 

\o 

\o 

\o 

\o 

100 

\o 

\o 

P 

\o 

377 

377 

030 

\o 

377 

377 

377 

377 

377 

377 

377 

377 

120 

377 

377 

377 

377 

\o 

\o 

002 

\o 

377 

377 

377 

377 

004 

\o 

006 

\o 

140 

\b 

\o 

377 

377 

377 

377 

\n 

\0 

026 

\o 

030 

\o 

377 

377 

032 

\o 

160 

377 

377 

377 

377 

034 

\o 

377 

377 

036 

\o 

377 

377 

377 

377 

377 

377 

200 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

520 

377 

377 

377 

377 


\o 

377 

377 

377 

377 

377 

377 

377 

377 

377 

377 

540 

377 

377 

377 

377 

377 

377 

007 

\o 

\r 

\o 

\f 

\o 

036 

\o 

037 

\o 

560 

024 

y. 

P 

1 

•/. 

c 

y. 

P 

2 

y. 

c 

\o 

\n 

\o 

035 

\o 

600 

\b 

\o 

030 

\o 

032 

\o 

\n 

\o 










Some limitations: total compiled entries cannot exceed 4096 bytes. The name field cannot exceed 
128 bytes. 

FILES 

/usr/lib/terminfo/?/* compiled terminal capability data base 
SEE ALSO 

tic(lM), curses(3X), terminfo(5). 
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NAME 

terminfo - terminal capability data base 
SYNOPSIS 

/usr/lib/terminfo/?/* 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Terminfo is a data base describing terminals that is used by programs and subroutines such as 
m(l) and curses{3X). Terminals are described in terminfo by giving a set of capabilities which 

they have, and by describing how operations are performed. Padding requirements and initializa¬ 

tion sequences are included in terminfo. 

Entries in terminfo consist of a number of separated fields. White space after each is 
ignored. The first entry for each terminal gives the names which are known for the terminal, 
separated by ‘I’ characters. The first name given is the most common abbreviation for the termi¬ 
nal, the last name given should be a long name fully identifying the terminal, and all others are 
understood as synonyms for the terminal name. All names but the last should be in lower case 
and contain no blanks; the last name may well contain upper case and blanks for readability. 

Terminal names (except for the last, verbose entry) should be chosen using the following conven¬ 
tions. The particular piece of hardware making up the terminal should have a root name chosen, 
thus “hp262r’. This name should not contain hyphens, except that synonyms may be chosen 
that do not conflict with other names. Modes that the hardware can be in, or user preferences, 
should be indicated by appending a hyphen and an indicator of the mode. Thus, a vtlOO in 132 
column mode would be vtlOO-w. The following suffixes should be used where possible: 


Suffix 

Meaning 

Example 

-w 

Wide mode (more than 80 columns) 

vtlOO-w 

-am 

With auto, margins (usually default) 

vtlOO-am 

-nam 

Without automatic margins 

vtlOO-nam 

-n 

Number of lines on the screen 

aaa-60 

-na 

No arrow keys (leave them in local) 

clOO-na 

-np 

Number of pages of memory 

cl00-4p 

-rv 

Reverse video 

clOO-rv 


CAPABILITIES 

The variable is the name by which the programmer (at the terminfo level) accesses the capability. 
The capname is the short name used in the text of the database, and is used by a person updating 
the database. The i.code is the two letter internal code used in the compiled database, and 
always corresponds to the old termcap capability name. 

Capability names have no hard length limit, but an informal limit of 5 characters has been 
adopted to keep them short and to allow the tabs in the source file caps to line up nicely. When¬ 
ever possible, names are chosen to be the same as or similar to the ANSI X3.64-1979 standard. 
Semantics are also intended to match those of the specification. 

(P) indicates that padding may be specified 

(G) indicates that the string is passed through tparm withparms as given (#?). 

(*) indicates that padding may be based on the number of lines affected 

(#^.) indicates the z ^ parameter. 
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Variable 

Cap- 

I. 

Booleans 

name 

Code 

auto__left__margin. 

bw 

bw 

auto_right__margin, 

am 

am 

beehive_glitch, 

xsb 

xb 

ceol—jstandout_glitch. 

xhp 

xs 

eat_newline_glitch, 

xenl 

xn 

erase_overstrike, 

eo 

eo 

generic_type, 

gn 

gn 

hard_copy, 

he 

he 

has_jneta_key. 

km 

km 

has_status_Jine, 

hs 

hs 

insert_Jiull_glitch, 

in 

in 

memory_above, 

da 

da 

memory_below. 

db 

db 

move_insert—mode. 

mir 

mi 

move_standout_mode. 

msgr 

ms 

over-strike, 

os 

os 

status_line_esc_ok, 

eslok 

es 

teleray_glitch, 

xt 

xt 

tilde—glitch, 

hz 

hz 

transparent_underline, 

ul 

ul 

xon_xoff, 

xon 

xo 

Numbers; 

columns, 

cols 

CO 

init_tabs. 

it 

it 

lines. 

lines 

li 

lines_of__memory, 

Im 

Im 

magic_cookie_glitch, 

xmc 

sg 

padding_baud_rate, 

pb 

pb 

virtual_terminal, 

vt 

vt 

width_status-Jine, 

wsl 

ws 

Strings; 

back-tab, 

cbt 

bt 

bell. 

bel 

bl 

carriage_return, 

cr 

cr 

change_scroll—region. 

csr 

cs 

clear-all—tabs. 

tbc 

ct 

clear—screen, 

clear 

cl 

cfr—eol, 

el 

ce 


-2- 


Description 

cubl wraps from column 0 to last 
column 

Terminal has automatic margins 
Beehive (fl=escape, f2=ctrl C) 

Standout not erased by overwriting 
(hp) 

newline ignored after 80 cols 
(Concept) 

Can erase overstrikes with a blank 
Generic line type (e.g.„ dialup, 
switch). 

Hardcopy terminal 

Has a meta key (shift, sets parity 

bit) 

Has extra "status line" 

Insert mode distinguishes nulls 
Display may be retained above the 
screen 

Display may be retained below the 
screen 

Safe to move while in insert mode 
Safe to move in standout modes 
Terminal overstrikes 
Escape can be used on the status line 
Tabs ruin, magic so char (Teleray 
1061) 

Hazeltine; can not print ~’s 
underline character overstrikes 
Terminal uses xon/xoff handshaking 

Number of colunms in a line 
Tabs initially every # spaces 
Number of lines on screen or page 
Lines of memory if > lines. 0 means 
varies 

Number of blank chars left by smso or 
rmso 

Lowest baud where cr/nl padding is 
needed 

Virtual terminal number (UNIX system) 
No. columns in status line 


Back tab (P) 

Audible signal (bell) (P) 

Carriage return (P*) 

change to lines #1 through #2 (vtlOO) 

(PC) 

Clear all tab stops (P) 

Clear screen and home cursor (P*) 
Clear to end of line (P) 
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clr_eos, 

ed 

cd 

Clear to end of display (P*) 

column_address, 

hpa 

ch 

Set cursor column (PC) 

command_character, 

cmdch 

CC 

Term, settable cmd char in prototype 

cursor_address. 

cup 

cm 

Screen rel. cursor motion row #1 
col #2 (PC) 

cursor-down, 

cudl 

do 

Down one line 

cursor-home. 

home 

ho 

Home cursor (if no cup) 

cursor—invisible, 

civis 

vi 

Make cursor invisible 

cursor—left. 

cubl 

le 

Move cursor left one space 

cur sor—mem_address, 

mrcup 

CM 

Memory relative cursor addressing 

cursor—normal. 

cnorm 

ve 

Make cursor appear normal (undo vs/vi) 

cursor—right. 

cufl 

nd 

Non-destructive space (cursor right) 

cursor—to—11, 

11 

11 

Last line, first column (if no cup) 

cursor-up, 

cuul 

up 

Upline (cursor up) 

cursor—visible. 

cvvis 

vs 

Make cursor very visible 

delete—character. 

dchl 

dc 

Delete character (P*) 

delete—line. 

dll 

dl 

Delete line (P*) 

dis—status—line. 

dsl 

ds 

Disable status line 

down_half—line, 

hd 

hd 

Half-line down (forward 1/2 linefeed) 

enter—alt—charset—mode, 

smacs 

as 

Start alternate character set (P) 

enter—blink__mode, 

blink 

mb 

Turn on blinking 

enter—bold_mode. 

bold 

md 

Turn on bold (extra bright) mode 

enter—ca—mode. 

smcup 

ti 

String to begin programs that use cup 

enter—delete—mode, 

smdc 

dm 

Delete mode (enter) 

enter—dim_mode, 

dim 

mh 

Turn on half-bright mode 

enter—insert—mode, 

smir 

im 

Insert mode (enter); 

enter—protected_mode, 

prot 

mp 

Turn on protected mode 

enter—reverse_mode. 

rev 

mr 

Turn on reverse video mode 

enter—secure—mode, 

invis 

mk 

Turn on blank mode (chars invisible) 

enter—standout—mode, 

smso 

so 

Begin stand out mode 

enter—underline—mode, 

smul 

us 

Start underscore mode 

erase—chars 

ech 

ec 

Erase #1 characters (PG) 

exit—alt—charset—mode. 

rmacs 

ae 

End alternate character set (P) 

exit—attribute—mode. 

sgrO 

me 

Turn off all attributes 

exit ca—mode. 

rmcup 

te 

String to end progreims that use cup 

exit—delete—mode, 

rmdc 

ed 

End delete mode 

exit_insert—mode. 

rmir 

ei 

End insert mode 

exit—standout—mode. 

rmso 

se 

End stand out mode 

exit—underline—mode, 

rmul 

ue 

End underscore mode 

flash_screen. 

flash 

vb 

Visible bell (may not move cursor) 

form_feed. 

ff 

ff 

Hardcopy terminal page eject (P*) 

from_status—line, 

fsl 

fs 

Return from status line 

init—Istring, 

isl 

il 

Terminal initialization string 

init—2string, 

is2 

i2 

Terminal initialization string 

init—Sstring, 

is3 

i3 

Terminal initialization string 

init—file. 

if 

if 

Name of file containing is 

insert—character. 

ichl 

ic 

Insert character (P) 

insert-line. 

ill 

al 

Add new blank line (P*) 

insert—padding. 

ip 

ip 

Insert pad after character inserted 
(P*) 

key_backspace. 

kbs 

kb 

Sent by backspace key 

key—catab. 

ktbc 

ka 

Sent by clear-all-tabs key 

key—clear. 

kclr 

kC 

Sent by clear screen or erase key 

key—ctab. 

kctab 

kt 

Sent by dear-tab key 
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key_dc, 

kdchl 

kD 

key_dl, 

kdll 

kL 

key_down, 

kcudl 

kd 

key_eic, 

krmir 

kM 

key_eol, 

kel 

kE 

key_eos, 

ked 

kS 

key_fO, 

kfO 

kO 

key__fl, 

kfl 

kl 

key_flO, 

kflO 

k; 

key_f2, 

kf2 

k2 

key__f3, 

kf3 

k3 

key__f4, 

kf4 

k4 

key_f5, 

kf5 

k5 

key_f6, 

kf6 

k6 

key_i7, 

kf7 

k7 

key_f8, 

kf8 

k8 

key_f9, 

kf9 

k9 

key_home, 

khome 

kh 

key_ic, 

kichl 

kl 

key_il, 

kill 

kA 

key_left, 

kcubl 

kl 

key__ll, 

kll 

kH 

key__npage, 

knp 

kN 

key_ppage, 

kpp 

kP 

f 

I 

kcufl 

kr 

key_sf, 

kind 

kF 

key_sr, 

kri 

kR 

key_stab, 

khts 

kT 

key_up, 

kcuul 

ku 

keypad-local, 

rmkx 

ke 

keypad—xmit, 

smkx 

ks 

lab_fO, 

IfO 

10 

lab_fl, 

Ifl 

11 

lab-flO, 

IflO 

la 

lab_f2, 

lf2 

12 

lab_f3, 

lf3 

13 

lab_f4, 

lf4 

14 

lab—f5, 

lf5 

15 

lab-f6, 

lf6 

16 

lab_f7, 

IfZ 

17 

lab_f8, 

lf8 

18 

lab_f9, 

lf9 

19 

memory—lock 

meml 

ml 

memory—unlock 

memu 

mu 

meta—on, 

smm 

mm 

meta—off. 

rmm 

mo 

newline, 

nel 

nw 

pad—char. 

pad 

pc 

parm_dch. 

dch 

DC 

parm_delete_line, 

dl 

DL 

parm—down_cursor. 

cud 

DO 

parm_ich. 

ich 

IC 

parm—index. 

indn 

SF 


Sent by delete character key 

Sent by delete line key 

Sent by terminal down arrow key 

Sent by rmir or smir in insert mode 

Sent by clear-to-end-of-line key 

Sent by clear-to-end-of-screen key 

Sent by function key fO 

Sent by function key fl 

Sent by function key flO 

Sent by function key f2 

Sent by function key f3 

Sent by function key f4 

Sent by function key f5 

Sent by function key f6 

Sent by function key f7 

Sent by function key f8 

Sent by function key f9 

Sent by home key 

Sent by ins char/enter ins mode key 

Sent by insert line 

Sent by terminal left arrow key 

Sent by home-down key 

Sent by next-page key 

Sent by previous-page key 

Sent by terminal right arrow key 

Sent by scroll-forward/down key 

Sent by scroll-backward/up key 

Sent by set-tab key 

Sent by terminal up arrow key 

Out of "keypad transmit" mode 

Put terminal in "keypad transmit" mode 

Labels on function key fO if not fO 

Labels on function key fl if not fl 

Labels on function key flO if not flO 

Labels on function key f2 if not f2 

Labels on function key f3 if not f3 

Labels on function key f4 if not f4 

Labels on function key f5 if not f5 

Labels on function key f6 if not f6 

Labels on function key fZ if not f7 

Labels on function key f8 if not f8 

Labels on function key f9 if not f9 

Enable memory lock 

Disable memory lock 

Turn on "meta mode" (8th bit) 

Turn off "meta mode" 

Newline (behaves like cr followed 
by If) 

Pad character (rather than null) 

Delete #1 chars (PG*) 

Delete #1 lines (PG*) 

Move cursor down #1 lines (PG*) 

Insert #1 blank chars (PG*) 

Scroll forward #1 lines (PG) 
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parm_insert_line, 

il 

AL 

Add #1 new blank lines (PG*) 

parm_left_cursor, 

cub 

LE 

Move cursor left #1 spaces (PG) 

parm_ri ght_cursor, 

cuf 

RI 

Move cursor right #1 spaces (PG*) 

parm_rindex, 

rin 

SR 

Scroll backward #1 lines (PG) 

parm_up_cursor, 

cuu 

UP 

Move cursor up #1 lines (PG*) 

pkey_key, 

pfkey 

pk 

Prog funct key #1 to type string #2 

pkey_local, 

pfloc 

pi 

Prog funct key #1 to execute string #2 

pkey_xmit, 

pfx 

px 

Prog funct key #1 to xmit string #2 

print_screen, 

mcO 

ps 

Print contents of the screen 

prtr_off, 

mc4 

pf 

Turn off the printer 

prtr_on, 

me 5 

po 

Turn on the printer 

repeat—char, 

rep 

rp 

Repeat char #1 #2 times. (PG*) 

reset_lstring, 

rsl 

rl 

Reset terminal completely to sane modes. 

reset_2string, 

rs2 

r2 

Reset terminal completely to sane modes. 

reset_3string, 

rs3 

r3 

Reset terminal completely to sane modes. 

reset_file. 

rf 

rf 

Name of file containing reset string 

restore_cursor, 

rc 

rc 

Restore cursor to position of last sc 

row_address, 

vpa 

cv 

Vertical position absolute 
(set row) (PG) 

save_cursor. 

sc 

sc 

Save cursor position (P) 

scroll_forward, 

ind 

sf 

Scroll text up (P) 

scroll_reverse, 

ri 

sr 

Scroll text down (P) 

set-attributes, 

sgr 

sa 

Define the video attributes (PG9) 

set—tab. 

hts 

st 

Set a tab in all rows, current column 

set—window. 

wind 

wi 

Current window is lines #l-#2 
cols #3-#4 

tab. 

ht 

ta 

Tab to next 8 space hardware tab stop 

to—status—line. 

tsl 

ts 

Go to status line, column #1 

underline—char. 

uc 

uc 

Underscore one char and move past it 

up—half—line, 

hu 

hu 

Half-line up (reverse 1/2 linefeed) 

init—prog. 

iprog 

iP 

Path name of program for init 

key—al, 

kal 

K1 

Upper left of keypad 

key—a3, 

ka3 

K3 

Upper right of keypad 

key—b2. 

kb2 

K2 

Center of keypad 

key—cl, 

kcl 

K4 

Lower left of keypad 

key—c3, 

kc3 

K5 

Lower right of keypad 

prtr—non, 

A Sample Entry 

mc5p 

pO 

Turn on the printer for bytes 


The following entry, which describes the Concept-100, is among the more complex entries in the 
terminfo file as of this writing. 

conceptlOO I clOOl concept | cl04 I cl00-4p I concept 100, 

am. bel='G, blank=\EH, blink=\EC, clear="L$<2*>. cnorm=\Ew. 
col8#80. cr=''M$<9>, cubl="H, cudl='J, cufl=\E=, 

cup=\Eay,pi7.’ ’7,+y,cy,p27,’ ’ y,■*•*/,c, 

cuul=\E:, cvvis=\EW, db. dchl=\E'A$<16*>. dim=\EE. dll=\E“B$<3*>. 
ed=\E"C$<16*>. el=\E"U$<16>. eo, fla8h=\Ek$<20>\EK. ht=\t$<8>. 

ill=\E“R$<3*>, in. ind='J, .ind='j$<9>. ip=$<16*>. 

i82=\EU\Ef\E7\E5\E8\El\ENH\EK\E\200\Eoit\200\Eo\47\E. 
kb8='h. kcubl=\E>. kcudl=\E<, kcufl=\E=. kcuul=\E:. 
kfl=\E5, kf2=\E6, kf3=\E7. khome=\E7. 

line8T^24, mir, pb#9600, prot=\EI. rep=\Ery,piy,c*/ip2y, ’ ’y,+%c$< .2*>, 

rev=\ED, rmcup=\Ev $<6>\Ep\r\n, rmir=\E\200, rmkxAEx, 

rm 80 =\Ed\Ee, rmul=\Eg, nnul=\Eg, 8gr0=\EN\200. 
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8mcup=\EU\Ev 8p\Ep\r, smir=\E‘P, sinkx=\EX, smso=\EE\ED, 
smul=\EG, tabs, ul, vt^8. xenl. 

Entries may continue onto multiple lines by placing white space at the beginning of each line 
except the first. Comments may be included on lines beginning with Capabilities in ter- 

minfo are of three types: Boolean capabilities which indicate that the terminal has some particu¬ 
lar feature, numeric capabilities giving the size of the terminal or the size of particular delays, and 
string capabilities, which give a sequence which can be used to perform particular terminal opera¬ 
tions. 

Types of Capabilities 

All capabilities have names. For instance, the fact that the Concept has automatic margins (i.e., 
an automatic return and linefeed when the end of a line is reached) is indicated by the capability 
am. Hence the description of the Concept includes am. Numeric capabilities are followed by the 
character and then the value. Thus cols, which indicates the number of columns the terminal 
has, gives the value ‘80’ for the Concept. 

Finally, string valued capabilities, such as el (clear to end of line sequence) are given by the two- 
character code, an ‘=’, and then a string ending at the next following A delay in milliseconds 
may appear anywhere in such a capability, enclosed in $<..> brackets, as in el=\EK$<3>, and 
padding characters are supplied by tputs to provide this delay. The delay can be either a number, 
e.g., ‘20’, or a number followed by an i.e., ‘3*’. A indicates that the padding required is 
proportional to the number of lines affected by the operation, and the amount given is the per- 
affected-unit padding required. (In the case of insert character, the factor is still the number of 
lines affected. This is always one unless the terminal has xenl and the software uses it.) When a 
is specified, it is sometimes useful to give a delay of the form ‘3.5’ to specify a delay per unit to 
tenths of milliseconds. (Only one decimal place is allowed.) 

A number of escape sequences are provided in the string valued capabilities for easy encoding of 
characters there. Both \E and \e map to an ESCAPE character, "x maps to a control-x for any 
appropriate x, and the sequences \n \1 \r \t \b \f \s give a newline, linefeed, return, tab, back¬ 
space, formfeed, and space. Other escapes include \" for % \\ for \, \, for comma, \; for :, and \0 
for null. (\0 will produce \200, which does not terminate a string but behaves as a null character 
on most terminals.) Finally, characters may be given as three octal digits after a \. 

Sometimes individual capabilities must be commented out. To do this, put a period before the 
capability name. For example, see the second ind in the example above. 

Preparing Descriptions 

We now outline how to prepare descriptions of terminals. The most effective way to prepare a 
terminal description is by imitating the description of a similar terminal in terminfo and to build 
up a description gradually, using partial descriptions with vi to check that they are correct. Be 
aware that a very unusual terminal may expose deficiencies in the ability of the terminfo file to 
describe it or bugs in vi. To easily test a new terminal description you can set the environment 
variable TERMINFO to a pathname of a directory containing the compiled description you are 
working on and programs will look there rather than in /usr/lib/terminfo. To get the padding for 
insert line right (if the terminal manufacturer did not document it) a severe test is to edit 
/etc/passwd at 9600 baud, delete 16 or so lines from the middle of the screen, then hit the ‘u’ key 
several times quickly. If the terminal messes up, more padding is usually needed. A similar test 
can be used for insert character. 

Basic Capabilities 

The number of columns on each line for the terminal is given by the cols numeric capability. If 
the terminal is a CRT, then the number of lines on the screen is given by the lines capability. If 
the terminal wraps around to the beginning of the next line when it reaches the right margin, 
then it should have the am capability. If the terminal can clear its screen, leaving the cursor in 
the home position, then this is given by the clear string capability. If the terminal overstrikes 
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(rather than clearing a position when a character is struck over) then it should have the os capa¬ 
bility. If the terminal is a printing terminal, with no soft copy unit, give it both he and os. (os 
applies to storage scope terminals, such as TEKTRONIX 4010 series, as well as hard copy and APL 
terminals.) If there is a code to move the cursor to the left edge of the current row, give this as 
cr. (Normally this will be carriage return, control M.) If there is a code to produce an audible 
signal (bell, beep, etc) give this as bel. 

If there is a code to move the cursor one position to the left (such as backspace) that capability 
should be given as cubl. Similarly, codes to move to the right, up, and down should be given as 
cufl, cuul, and cudl. These local cursor motions should not alter the text they pass over, for 
example, you would not normally use ‘cufl= ’ because the space would erase the character moved 
over. 

A very important point here is that the local cursor motions encoded in terminfo are undefined at 
the left and top edges of a CRT terminal. Programs should never attempt to backspace around 
the left edge, unless bw is given, and never attempt to go up locally off the top. In order to scroll 
text up, a program will go to the bottom left corner of the screen and send the ind (index) string. 

To scroll text down, a program goes to the top left corner of the screen and sends the ri (reverse 
index) string. The strings ind and ri are undefined when not on their respective corners of the 
screen. 

Parameterized versions of the scrolling sequences are indn and rin which have the same seman¬ 
tics as ind and ri except that they take one parameter, and scroll that many lines. They are also 
undefined except at the appropriate edge of the screen. 

The am capability tells whether the cursor sticks at the right edge of the screen when text is out¬ 
put, but this does not necessarily apply to a cufl from the last column. The only local motion 
which is defined from the left edge is if bw is given, then a cubl from the left edge will move to 
the right edge of the previous row. If bw is not given, the effect is undefined. This is useful for 
drawing a box around the edge of the screen, for example. If the terminal has switch selectable 
automatic margins, the terminfo file usually assumes that this is on; i.e., am. If the terminal has 
a command which moves to the first column of the next line, that command can be given as nel 
(newline). It does not matter if the command clears the remainder of the current line, so if the 
terminal has no cr and If it may still be possible to craft a working nel out of one or both of 
them. 

These capabilities suffice to describe hardcopy and glass-tty terminals. Thus the model 33 tele¬ 
type is described as 

33 I tty33 I tty I model 33 teletype, 

bel="G, cols:j^72, cr="M, cudl='J, he, ind="j, os, 

while the Lear Siegler ADM-3 is described as 
adm3 I 3 I Isi adm3, 

am, bel=''G, clear="Z, cols^^SO, cr="M, cubl="H, cudl=''J, 
ind="J, lines^24. 

Parameterized Strings 

Cursor addressing and other strings requiring parameters in the terminal are described by a 
parameterized string capability, with printf(3S) like escapes %x in it. For example, to address 
the cursor, the cup capability is given, using two parameters: the row and column to address to. 
(Rows and columns are numbered from zero and refer to the physical screen visible to the user, 
not to any unseen memory.) If the terminal has memory relative cursor addressing, that can be 
indicated by mrcup. 

The parameter mechanism uses a stack and special % codes to manipulate it. Typically a 
sequence will push one of the parameters onto the stack and then print it in some format. Often 
more complex operations are necessary. 
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The % encodings have the following meanings: 


%% 

outputs 

%d 

print pop() as in printf 

%2d 

print pop() like %2d 

%3d 

print pop() like %3d 

%02d 

%03d 

as in printf 

%c 

print pop() gives %c 

%s 

print pop() gives %s 

%p[l-9l 

push ith parm 

%P[a-z] 

set variable [a-z] to pop() 

%g[a-z] 

get variable |a-z] and push it 

%’c’ 

char constant c 

%{nn} 

integer constant nn 

%+ %- %* %/ %m 

%k%\ 

arithmetic (%m is mod): push(pop() op pop()) 
bit operations: push(pop() op pop()) 

%= %> %< 

logical operations: push(pop() op pop()) 

%l %~ 

unary operations push(op pop()) 

%i 

add 1 to first two parms (for ANSI terminals) 


%? expr %t thenpart %e elsepart %; 

if-then-else, %e elsepart is optional, 
else-if s are possible ala Algol 68: 

%? Cj %t %e C 2 %t %e %t b^ %e %t b^ %e %; 
are conditions, b- are bodies. 

Binary operations are in postfix form with the operands in the usual order. That is, to get x-5 
one would use "%gx%{5}%-". 

Consider the HP2645, which, to get to row 3 and column 12, needs to be sent \E&;al2c03Y pad¬ 
ded for 6 milliseconds. Note that the order of the rows and columns is inverted here, and that the 
row and column are printed as two digits. Thus its cup capability is 
cup=6\E&%p2%2dc%pl%2dY. 

The Microterm ACT-IV needs the current row and column sent preceded by a "T, with the row 
and column simply encoded in binary, cup="T%pl%c%p2%c. Terminals which use %c need to be 
able to backspace the cursor (cubl), and to move the cursor up one line on the screen (cuul). 
This is necessary because it is not always safe to transmit \n ''D and \r, as the system may 
change or discard them. (The library routines dealing with terminfo set tty modes so that tabs 
are never expanded, so \t is safe to send. This turns out to be essential for the Ann Arbor 4080.) 

A final example is the LSI ADM-3a, which uses row and column offset by a blank character, thus 
cup=\E=%pl%’ ’%+%c%p2%’ ’%+%c. After sending ‘\E=’, this pushes the first parameter, 
pushes the ASCII value for a space (32), adds them (pushing the sum on the stack in place of the 
two previous values) and outputs that value as a character. Then the same is done for the second 
parameter. More complex arithmetic is possible using the stack. 

If the terminal has row or column absolute cursor addressing, these can be given as single param¬ 
eter capabilities hpa (horizontal position absolute) and vpa (vertical position absolute). Some¬ 
times these are shorter than the more general two parameter sequence (as with the hp2645) and 
can be used in preference to cup . If there are parameterized local motions (e.g., move n spaces to 
the right) these can be given as cud, cub, cuf, and cuu with a single parameter indicating how 
many spaces to move. These are primarily useful if the terminal does not have cup, such as the 
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TEKTRONIX 4025. 

Cursor Motions 

If the terminal has a fast way to home the cursor (to very upper left corner of screen) then this 
can be given as home; similarly a fast way of getting to the lower left-hand corner can be given 
as 11; this may involve going up with cuul from the home position, but a program should never 
do this itself (imless 11 does) because it can make no assumption about the effect of moving up 
from the home position. Note that the home position is the same as addressing to (0,0): to the 
top left corner of the screen, not of memory. (Thus, the \EH sequence on HP terminals cannot be 
used for home.) 

Area Clears 

If the terminal can clear from the current position to the end of the line, leaving the cursor where 
it is, this should be given as el. If the terminal can clear from the current position to the end of 
the display, then this should be given as ed. Ed is only defined from the first column of a line. 
(Thus, it can be simulated by a request to delete a large number of lines, if a true ed is not avail¬ 
able.) 

Insert/delete line 

If the terminal can open a new blank line before the line where the cursor is, this should be given 
as ill; this is done only from the first position of a line. The cursor must then appear on the 
newly blank line. If the terminal can delete the line which the cursor is on, then this should be 
given as dll; this is done only from the first position on the line to be deleted. Versions of ill 
and dll which take a single parameter and insert or delete that many lines can be given as il and 
dl. If the terminal has a settable scrolling region (like the vtlOO) the command to set this can be 
described with the csr capability, which takes two parameters: the top and bottom lines of the 
scrolling region. The cursor position is, alas, undefined after using this command. It is possible to 
get the effect of insert or delete line using this command - the sc and rc (save and restore cursor) 
commands are also useful. Inserting lines at the top or bottom of the screen can also be done 
using ri or ind on many terminals without a true insert/delete line, and is often faster even on 
terminals with those features. 

If the terminal has the ability to define a window as part of memory, which all commands affect, 
it should be given as the parameterized string wind. The four parameters are the starting and 
ending lines in memory and the starting and ending columns in memory, in that order. 

If the terminal can retain display memory above, then the da capability should be given; if 
display memory can be retained below, then db should be given. These indicate that deleting a 
line or scrolling may bring non-blank lines up from below or that scrolling back with ri may bring 
down non-blank lines. 

Insert/Delete Character 

There are two basic kinds of intelligent terminals with respect to insert/delete character which 
can be described using terminfo. The most common insert/delete character operations affect only 
the characters on the current line and shift characters off the end of the line rigidly. Other termi¬ 
nals, such as the Concept 100 and the Perkin Elmer Owl, make a distinction between typed and 
untyped blanks on the screen, shifting upon an insert or delete only to an untyped blank on the 
screen which is either eliminated, or expanded to two untyped blanks. You can determine the 
kind of terminal you have by clearing the screen and then typing text separated by cursor 
motions. Type abc def using local cursor motions (not spaces) between the abc and the def. 
Then position the cursor before the abc and put the terminal in insert mode. If typing characters 
causes the rest of the line to shift rigidly and characters to fall off the end, then your terminal 
does not distinguish between blanks and untyped positions. If the abc shifts over to the def which 
then move together around the end of the current line and onto the next as you insert, you have 
the second type of terminal, and should give the capability in, which stands for insert null. While 
these are two logically separate attributes (one line vs. multiline insert mode, and special 
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treatment of untyped spaces) we have seen no terminals whose insert mode cannot be described 
with the single attribute. 

Terminfo can describe both terminals which have an insert mode, and terminals which send a 
simple sequence to open a blank position on the current line. Give as smir the sequence to get 
into insert mode. Give as rmir the sequence to leave insert mode. Now give as ichl any 
sequence needed to be sent just before sending the character to be inserted. Most terminals with 
a true insert mode will not give ichl; terminals which send a sequence to open a screen position 
should give it here. (If your terminal has both, insert mode is usually preferable to ichl. Do not 
give both unless the terminal actually requires both to be used in combination.) If post insert 
padding is needed, give this as a number of milliseconds in ip (a string option). Any other 
sequence which may need to be sent after an insert of a single character may also be given in ip. 
If your terminal needs both to be placed into an ‘insert mode’ and a special code to precede each 
inserted character, then both smir/rmir and ichl can be given, and both will be used. The ich 
capability, with one parameter, n, will repeat the effects of ichl n times. 

It is occasionally necessary to move around while in insert mode to delete characters on the same 
line (e.g., if there is a tab after the insertion position). If your terminal allows motion while in 
insert mode you can give the capability mir to speed up inserting in this case. Omitting mir will 
affect only speed. Some terminals (notably Datamedia’s) must not have mir because of the way 
their insert mode works. 

Finally, you can specify dchl to delete a single character, dch with one parameter, n, to delete n 
characters, and delete mode by giving smdc and rmdc to enter and exit delete mode (any mode 
the terminal needs to be placed in for dchl to work). 

A. command to erase n characters (equivalent to outputting n blanks without moving the cursor) 
can be given as ech with one parameter. 

Highlighting, Underlining, and Visible Bells 

If your terminal has one or more kinds of display attributes, these can be represented in a number 
of different ways. You should choose one display form as standout mode, representing a good, 
high contrast, easy-on-the-eyes, format for highlighting error messages and other attention 
getters. (If you have a choice, reverse video plus half-bright is good, or reverse video alone.) The 
sequences to enter and exit standout mode are given as smso and rmso, respectively. If the code 
to change into or out of standout mode leaves one or even two blank spaces on the screen, as the 
TVI 912 and Teleray 1061 do, then xmc should be given to tell how many spaces are left. 

Codes to begin underlining and end underlining can be given as smul and rmul respectively. If 
the terminal has a code to underline the current character and move the cursor one space to the 
right, such as the Microterm Mime, this can be given as uc. 

Other capabilities to enter various highlighting modes include blink (blinking) bold (bold or 
extra bright) dim (dim or half-bright) invis (blanking or invisible text) prot (protected) rev 
(reverse video) sgrO (turn off all attribute modes) smacs (enter alternate character set mode) and 
rmacs (exit alternate character set mode). Turning on any of these modes singly may or may 
not turn oflF other modes. 

If there is a sequence to set arbitrary combinations of modes, this should be given as sgr (set 
attributes), taking 9 parameters. Each parameter is either 0 or 1, as the corresponding attribute 
is on or off. The 9 parameters are, in order: standout, underline, reverse, blink, dim, bold, blank, 
protect, alternate character set. Not all modes need be supported by sgr, only those for which 
corresponding separate attribute commands exist. 

Terminals with the “magic cookie” glitch (xmc) deposit special “cookies” when they receive 
mode-setting sequences, which affect the display algorithm rather than having extra bits for each 
character. Some terminals, such as the HP 2621, automatically leave standout mode when they 
move to a new line or the cursor is addressed. Programs using standout mode should exit stan¬ 
dout mode before moving the cursor or sending a newline, unless the msgr capability, asserting 
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that it is safe to move in standout mode, is present. 

If the terminal has a way of flashing the screen to indicate an error quietly (a bell replacement) 
then this can be given as flash; it must not move the cursor. 

If the cursor needs to be made more visible than normal when it is not on the bottom line (to 
make, for example, a non-blinking underline into an easier to find block or blinking underline) 
give this sequence as cvvis. If there is a way to make the cursor completely invisible, give that as 
civis. The capability cnorm should be given which undoes the effects of both of these modes. 

If the terminal needs to be in a special mode when running a program that uses these capabilities, 
the codes to enter and exit this mode can be given as smcup and rmcup. This arises, for exam¬ 
ple, from terminals like the Concept with more than one page of memory. If the terminal has 
only memory relative cursor addressing and not screen relative cursor addressing, a one screen¬ 
sized window must be fixed into the terminal for cursor addressing to work properly. This is also 
used for the TEKTRONIX 4025, where smcup sets the command character to be the one used by 
terminfo. 

If your terminal correctly generates underlined characters (with no special codes needed) even 
though it does not overstrike, then you should give the capability ul. If overstrikes are erasable 
with a blank, then this should be indicated by giving eo. 

Keypad 

If the terminal has a keypad that transmits codes when the keys are pressed, this information can 
be given. Note that it is not possible to handle terminals where the keypad only works in local 
(this applies, for example, to the unshifted HP 2621 keys). If the keypad can be set to transmit or 
not transmit, give these codes as smkx and rmkx. Otherwise the keypad is assumed to always 
transmit. The codes sent by the left arrow, right arrow, up arrow, down arrow, and home keys 
can be given as kcubl, kcufl, kcuul, kcudl, and khome respectively. If there are function 
keys such as fO, fl, ..., flO, the codes they send can be given as kfO, kfl, kflO. If these keys 
have labels other than the default fO through flO, the labels can be given as IfO, Ifl, IflO. 
The codes transmitted by certain other special keys can be given: kll (home down), kbs (back¬ 
space), ktbc (clear all tabs), kctab (clear the tab stop in this column), kclr (clear screen or erase 
key), kdchl (delete character), kdll (delete line), krmir (exit insert mode), kel (clear to end of 
line), ked (clear to end of screen), kichl (insert character or enter insert mode), kill (insert line), 
knp (next page), kpp (previous page), kind (scroll forward/down), kri (scroll backward/up), 
khts (set a tab stop in this column). In addition, if the keypad has a 3 by 3 array of keys includ¬ 
ing the four arrow keys, the other five keys can be given as kal, ka3, kb2, kcl, and kc3. These 
keys are useful when the effects of a 3 by 3 directional pad are needed. 

Tabs and Initialization 

If the terminal has hardware tabs, the command to advance to the next tab stop can be given as 
ht (usually control I). A “backtab” command which moves leftward to the next tab stop can be 
given as cbt. By convention, if the teletype modes indicate that tabs are being expanded by the 
computer rather than being sent to the terminal, programs should not use ht or cbt even if they 
are present, since the user may not have the tab stops properly set. If the terminal has hardware 
tabs which are initially set every n spaces when the terminal is powered up, the numeric parame¬ 
ter it is given, showing the number of spaces the tabs are set to. This is normally used by the 
tset command to determine whether to set the mode for hardware tab expansion, and whether to 
set the tab stops. If the terminal has tab stops that can be saved in nonvolatile memory, the ter¬ 
minfo description can assume that they are properly set. 

Other capabilities include isl, is2, and is3, initialization strings for the terminal, iprog, the path 
name of a program to be run to initialize the terminal, and if, the name of a file containing long 
initialization strings. These strings are expected to set the terminal into modes consistent with 
the rest of the terminfo description. They are normally sent to the terminal, by the tset program, 
each time the user logs in. They will be printed in the following order: isl; is2; setting tabs 
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using tbc and hts; if; running the program iprog; and finally is3. Most initialization is done 
with is2. Special terminal modes can be set up without duplicating strings by putting the com¬ 
mon sequences in is2 and special cases in isl and is3. A pair of sequences that does a harder 
reset from a totally unknown state can be analogously given as rsl, rs2, rf, and rs3, analogous to 
is2 and if. These strings are output by the reset program, which is used when the terminal gets 
into a wedged state. Commands are normally placed in rs2 and rf only if they produce annoying 
effects on the screen and are not necessary when logging in. For example, the command to set the 
vtlOO into 80-column mode would normally be part of is2, but it causes an annoying glitch of the 
screen and is not normally needed since the terminal is usually already in 80 column mode. 

If there are commands to set and clear tab stops, they can be given as tbc (clear all tab stops) 
and hts (set a tab stop in the current column of every row). If a more complex sequence is 
needed to set the tabs than can be described by this, the sequence can be placed in is2 or if. 

Delays 

Certain capabilities control padding in the teletype driver. These are primarily needed by hard 
copy terminals, and are used by the tset program to set teletype modes appropriately. Delays 
embedded in the capabilities cr, ind, cubl, ff, and tab will cause the appropriate delay bits to be 
set in the teletype driver. If pb (padding baud rate) is given, these values can be ignored at baud 
rates below the value of pb. 

Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, then this can be given as pad. 
Only the first character of the pad string is used. 

If the terminal has an extra “status line” that is not normally used by software, this fact can be 
indicated. If the status line is viewed as an extra line below the bottom line, into which one can 
cursor address normally (such as the Heathkit hl9’s 25th line, or the 24th line of a vtlOO which is 
set to a 23-line scrolling region), the capability hs should be given. Special strings to go to the 
beginning of the status line and to return from the status line can be given as tsl and fsl. (fsl 
must leave the cursor position in the same place it was before tsl. If necessary, the sc and rc 
strings can be included in tsl and fsl to get this effect.) The parameter tsl takes one parameter, 
which is the column number of the status line the cursor is to be moved to. If escape sequences 
and other special commands, such as tab, work while in the status line, the flag eslok can be 
given. A string which turns off the status line (or otherwise erases its contents) should be given 
as dsl. If the terminal has commands to save and restore the position of the cursor, give them as 
sc and rc. The status line is normally assumed to be the same width as the rest of the screen, 
e.g., cols. If the status line is a different width (possibly because the terminal does not allow an 
entire line to be loaded) the width, in columns, can be indicated with the numeric parameter wsl. 

If the terminal can move up or down half a line, this can be indicated with hu (half-line up) and 
hd (half-line down). This is primarily useful for superscripts and subscripts on hardcopy termi¬ 
nals. If a hardcopy terminal can eject to the next page (form feed), give this as ff (usually control 
L). 

If there is a command to repeat a given character a given number of times (to save time transmit¬ 
ting a large number of identical characters) this can be indicated with the parameterized string 
rep. The first parameter is the character to be repeated and the second is the number of times to 
repeat it. Thus, tparm(repeat_char, V, 10) is the same as ‘xxxxxxxxxx’. 

If the terminal has a settable command character, such as the TEKTRONIX 4025, this can be indi¬ 
cated with cmdch. A prototype command character is chosen which is used in all capabilities. 
This character is given in the cmdch capability to identify it. The following convention is sup¬ 
ported on some UNIX systems: The environment is to be searched for a CC variable, and if 
found, all occurrences of the prototype character are replaced with the character in the environ¬ 
ment variable. 
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Terminal descriptions that do not represent a specific kind of known terminal, such as switch^ 
dialup, patch, and network, should include the gn (generic) capability so that programs can com¬ 
plain that they do not know how to talk to the terminal. (This capability does not apply to vir¬ 
tual terminal descriptions for which the escape sequences are known.) 

If the terminal uses xon/xoff handshaking for flow control, give xon. Padding information should 
still be included so that routines can make better decisions about costs, but actual pad characters 
will not be transmitted. 

If the terminal has a “meta key” which acts as a shift key, setting the 8th bit of any character 
transmitted, this fact can be indicated with km. Otherwise, software will assume that the 8th bit 
is parity and it will usually be cleared. If strings exist to turn this “meta mode” on and off, they 
can be given as smm and rmm. 

If the terminal has more lines of memory than will fit on the screen at once, the number of lines of 
memory can be indicated with Im. A value of lm#0 indicates that the number of lines is not 
fixed, but that there is still more memory than fits on the screen. 

If the terminal is one of those supported by the UNIX virtual terminal protocol, the terminal 
number can be given as vt. 

Media copy strings which control an auxiliary printer connected to the terminal can be given as 
mcO: print the contents of the screen, mc4: turn off the printer, and mc5; turn on the printer. 
When the printer is on, all text sent to the terminal will be sent to the printer. It is undefined 
whether the text is also displayed on the terminal screen when the printer is on. A variation 
mc5p takes one parameter, and leaves the printer on for as many characters as the value of the 
parameter, then turns the printer off. The parameter should not exceed 255. All text, including 
mc4, is transparently passed to the printer while an mc5p is in effect. 

Strings to program function keys can be given as pfkey, pfloc, and pfx. Each of these strings 
takes two parameters: the function key number to program (from 0 to 10) and the string to pro¬ 
gram it with. Function key numbers out of this range may program undefined keys in a terminal 
dependent manner. The difference between the capabilities is that pfkey causes pressing the 
given key to be the same as the user typing the given string; pfloc causes the string to be exe¬ 
cuted by the terminal in local; and pfx causes the string to be transmitted to the computer. 

Glitches and Braindamage 

Hazeltine terminals, which do not allow characters to be displayed should indicate hz. 

Terminals which ignore a linefeed immediately after an am wrap, such as the Concept and vtlOO, 
should indicate xenl. 

If el is required to get rid of standout (instead of merely writing normal text on top of it), xhp 
should be given. 

Teleray terminals, where tabs turn all characters moved over to blanks, should indicate xt (des¬ 
tructive tabs). This glitch is also taken to mean that it is not possible to position the cursor on 
top of a “magic cookie”, that to erase standout mode it is instead necessary to use delete and 
insert line. 

The Beehive Superbee, which is unable to correctly transmit the escape or control C characters, 
has xsb, indicating that the fl key is used for escape and f2 for control C. (Only certain Super¬ 
bees have this problem, depending on the ROM.) 

Other specific terminal problems may be corrected by adding more capabilities of the form xz. 
Similar Terminals 

If there are two very similar terminals, one can be defined as being just like the other with certain 
exceptions. The string capability use can be given with the name of the similar terminal. The 
capabilities given before use override those in the terminal type invoked by use. A capability can 
be cancelled by placing xx@ to the left of the capability definition, where xx is the capability. 
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For example, the entry 

2621-nl, smkx@, rmkx@, use=2621, 

defines a 2621-nl that does not have the smkx or rmkx capabilities, and hence does not turn on 
the function key labels when in visual mode. This is useful for different modes for a terminal, or 
for different user preferences. 

FILES 

/usr/lib/terminfo/?/* files containing terminal descriptions 
SEE ALSO 

tic(lM), curses(3X), printf(3S), term(5). 


Hewlett-Packard 


-14- 


July 9, 1985 



TTYTYPE(5) 


TTYTYPE(5) 


NAME 

ttytype - data base of terminal types by port 

SYNOPSIS 

/etc/ttytype 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: UCB 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Ttytype is a database containing, for each tty port on the system, the kind of terminal that is 
attached to that port. There is one line per port, containing the terminal kind (as a name listed 
in terminfo{b)), a space, and the name of the tty, less the initial "/dev/". For example, for an HP 
2622 terminal on tty02: 

2622 tty02 

This information is read by tset(l) and by login{l) to initialize the TERM variable at login time. 

SEE ALSO 

login(l), tset(l). 

BUGS 

Some lines are only known as "dialup" or "plugboard". 
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NAME 

utmp, wtmp, btmp - utmp, wtmp, btmp entry format 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V and UCB 

SYNOPSIS 

^include <sys/types.h> 

#include <utmp.h> 


DESCRIPTION 

These files, which hold user and accounting information for such commands as last(l), who{l), 
write{l), and login{l), have the following structure as defined by <utmp.h>: 


#define UTMP_JFILE 
#define WTMP_FILE 

#define ut_name ut_user 
struct utmp 
{ 

char ut_user[8]; 

char ut_id [4]; 

char ut_line[12]; 

short ut_pid; 

short ut_type; 

struct exit—status { 
short e_termination 

short e_exit; 

} ut_exit; 

time_t ut_time; 

}; 


"/etc/utmp" 
"/etc/wtmp" 


/* User login name */ 

/* /etc/inittab id (usually line #) */ 
/* device name (console, Inxx) ♦/ 

/* process id ♦/ 

/ * type of entry * / 

; /♦ Process termination status ♦/ 

/* Process exit status */ 

/♦ The exit status of a process 
* marked as DEAD_PROCESS. */ 

/* time entry was made */ 


/* Definitions for ut_type */ 


#define EMPTY 0 

#define RUN_LVL 1 

#define BOOT_TIME 2 

#define OLD_TIME 3 

#define NEW_TIME 4 

#define INIT_PROCESS 5 

#define LOGIN_PROCESS 6 

#define USER_PROCESS 7 

#define DEAD_PROCESS 8 

#define ACCOUNTING 9 


#define UTMAXTYPE ACCOUNTING 


/* Process spawned by "init" ♦/ 

/* A "getty" process waiting for login */ 
/* A user process */ 

/* Largest legal value of ut_type */ 
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/♦ Special strings or formats used in the "ut_Jine" field when +/ 
/* accounting for something other than a process +/ 

/* No string for the ut_line field can be more than 11 chars + */ 
/* a NULL in length */ 


#define RUNLVL_MSG 
#defineBOOT_MSG 
#define OTIME_MSG 
#define NTIME_MSG 


"run-level %c" 
"system boot" 
"old time" 
"new time" 


Ut_name is valid for login entries only; otherwise the first character is null. There are logout 

entries in both utmp and wtmp. In utmp, these entries refer to terminals that are not 
currently logged in; in wtmp, they record history. File btmp contains bad login entries for each 
invalid logon attempt. 

Note that wtmp and btmp tend to grow without bound, and should be checked regularly. 
Information that is no longer useful should be removed periodically to prevent it from becoming 
too large. 


FILES 

/etc/utmp 

/etc/wtmp 

/etc/btmp 

SEE ALSO 

acctcon(lM), fwtmp(lm), last(l), lastb(l), login(l), who(l), write(l), getut(3G). 
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NAME 

intro - introduction to miscellany 
DESCRIPTION 

This section describes miscellaneous facilities such as macro packages, character set tables, etc. 
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NAME 

ascii - map of ASCII character set 
SYNOPSIS 

cat /usr/pub/ascii 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

Ascii is a map of the ASCII character set, giving both octal and hexadecimal equivalents of each 
character, to be printed as needed. It contains: 


1000 

nul 

1001 

soh 

1002 

stx 

1003 

etx 

1004 

eot 

1005 

enq 

1006 

ack 

1007 

bel 

1010 

bs 

1011 

ht 

1012 

nl 

1013 

vt 

1014 

np 

1015 

cr 

1016 

so 

1017 

s i 

1020 

die 

1021 

del 

1022 

dc2 

1023 

dc3 

1024 

dc4 

1025 

nak 

1026 

syn 

1027 

etb 

1030 

can 

1031 

em 

1032 

sub 

1033 

esc 

1034 

f s 

1035 

gs 

1036 

rs 

1037 

us 

1040 

sp 

1041 

j 

1042 

" 

1043 

# 

1044 

$ 

1045 

% 

1046 

& 

1047 


1050 

( 

1051 

) 

1052 

* 

1053 

+ 

1054 

, 

1055 

- 

1056 


1057 

/ 

1060 

0 

1061 

1 

1062 

2 

1063 

3 

1064 

4 

1065 

5 

1066 

6 

1067 

7 

1070 

8 

1071 

9 

1072 


1073 

; 

1074 

< 

1075 

= 

1076 

> 

1077 

? 

1100 

@ 

1101 

A 

1102 

B 

1103 

C 

1104 

D 

1105 

E 

1 106 

F 

1107 

G 

1110 

H 

1111 

I 

1112 

J 

1113 

K 

1114 

L 

1115 

M 

1 116 

N 

1117 

0 

1120 

P 

1121 

Q 

1122 

R 

1123 

S 

1124 

T 

1125 

U 

1126 

V 

1127 

W 

1130 

X 

1131 

Y 

1132 

Z 

1133 

[ 

1134 

\ 

1135 

) 

1 136 


1137 

_ 

140 


1141 

a 

1142 

b 

1143 

c 

1144 

d 

1145 

e 

1146 

f 

1147 

g 

1150 

h 

1151 

i 

1152 

j 

1153 

k 

1154 

1 

1155 

m 

1156 

n 

1157 

o 

160 

P 

1161 

q 

1162 

r 

1163 

s 

1164 

t 

1165 

u 

1166 

V 

1167 

w 

1170 

X 

1171 

y 

1172 

z 

1173 

{ 

1174 

1 

1175 

} 

1176 


1177 

del 

1 00 

nul 

1 01 

soh 

1 02 

stx 

1 03 

etx 

1 04 

eot 

1 05 

enq 

1 06 

ack 

1 07 

be 1 

1 08 

bs 

1 09 

ht 

1 Oa 

nl 

1 Ob 

vt 

1 Oc 

np 

1 Od 

cr 

1 Oe 

so 

1 Of 

s i 

1 10 

die 

1 11 

del 

1 12 

dc2 

1 13 

dc3 

1 14 

dc4 

1 15 

nak 

1 16 

syn 

1 17 

etb 

1 18 

can 

1 19 

em 

1 la 

sub 

1 lb 

esc 

1 Ic 

f s 

1 Id 

gs 

1 le 

rs 

1 If 

us 

1 20 

sp 

1 21 

! 

1 22 

" 

1 23 

# 

1 24 

$ 

1 25 

% 

1 26 

h 

1 27 


1 28 

( 

1 29 

) 

1 2a 

* 

1 2b 

+ 

1 2c 

, 

1 2d 

- 

1 2e 


1 2f 

/ 

1 30 

0 

1 31 

1 

1 32 

2 

1 33 

3 

1 34 

4 

1 35 

5 

1 36 

6 

1 37 

7 

1 38 

8 

1 39 

9 

1 3a 


1 3b 

; 

1 3c 

< 

1 3d 

= 

1 3e 

> 

1 3f 

? 

1 40 

@ 

1 41 

A 

1 42 

B 

1 43 

c 

1 44 

D 

1 45 

E 

1 46 

F 

1 47 

G 

1 48 

H 

1 49 

I 

1 4a 

J 

1 4b 

K 

1 4c 

L 

1 4d 

M 

1 4e 

N 

1 4f 

O 

1 50 

P 

1 51 

Q 

1 52 

R 

1 53 

S 

1 54 

T 

1 55 

U 

1 56 

V 

1 57 

W 

1 58 

X 

1 59 

Y 

1 5a 

Z 

1 5b 

[ 

1 5c 

\ 

1 5d 

1 

1 5e 


1 5f 

_ 

1 60 


1 61 

a 

1 62 

b 

1 63 

c 

1 64 

d 

1 65 

e 

1 66 

f 

1 67 

g 

1 68 

h 

1 69 

i 

1 6a 

j 

1 6b 

k 

1 6c 

1 

1 6d 

m 

1 6e 

n 

1 6f 

0 

1 70 

P 

1 71 

q 

1 72 

r 

1 73 

s 

1 74 

t 

1 75 

u 

1 76 

V 

1 77 

w 

1 78 

X 

1 79 

y 

1 7a 

z 

1 7b 

{ 

1 7c 

1 

1 7d 

} 

1 7e 

~ 

1 7f 

del 


FILES 

/usr/pub/ascii 
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NAME 

environ - user environment 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System III 

DESCRIPTION 

An array of strings called the “environment” is made available by exec (2) when a process begins. 
By convention, these strings have the form “name=value”. The following names are used by 
various commands: 

PATH The sequence of directory prefixes that sh(l), time(l), mce(l), nohup(l)^ etc., apply in 
searching for a file known by an incomplete path name. The prefixes are separated by 
colons (;). Logm(l) sets PATH=;/bin:/usr/bin. 

HOME Name of the user’s login directory, set by logm(l) from the password file passwd{b). 
TERM The kind of terminal for which output is to be prepared. This information is used by 
commands (such as mm(l) or w(l)) that are able to exploit special capabilities of that 
terminal. 

TZ Time zone information. The minimum format is tznamediff where tzname is an “alpha¬ 
betic” string giving the time zone name or abbreviation, and diff is the (positive or nega¬ 
tive, and possibly fractional) difference in hours from GMT. NOTE: west is positive, east 
is negative. If a summer time zone adjustment (such as Daylight Savings in the US) is to 
be applied the format is tzname d^flidstzname where dstzname is the name of the 
“Daylight Savings” time zone. 

LANG Language selection. This is one of the names listed in langid{7). It is used to select the 
character set, lexical order, up and down shift tables, and other information which varies 
from one area to another. 

Further names may be placed in the environment by the export command and “name=value” 
arguments in sh(l), by the setenv command in csh{l), by the env{l) command, or by exec{2). It 
is unwise to conflict with certain shell variables that are frequently exported by .profile files: 
MAIL, PSl, PS2, IFS. 

SEE ALSO 

env(l), login(l), sh(l), exec(2), ctime(3C), getenv(3C), profile(5), tztab(5), hpnls(7), term(7). 
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NAME 

fcntl - file control options 
SYNOPSIS 

#include <fcntl.h> 

HP-UX COMPATIBILITY 
Level: 

Basic calls: HP-UX/RUN ONLY 
Real time extensions: HP-UX/STANDARD - Real Time 
Origin: System III, System V, UCB, and HP 

DESCRIPTION 

The fcntl(2) function provides for control over open files. This include file describes requests and 
arguments to fcntl and open (2). 

/* Flag values accessible to open(2) and fcntl(2) */ 

/* (The first three can only be set by open) */ 


#define 0_RD0NLY 0 
#define 0_WR0NLY 1 
#define 0_RDWR 2 
#define 0_NDELAY 04 
#define 0_APPEND 010 
#define 0_SYNCI0 0100000 


/* Non-blocking I/O */ 

/* append (writes guaranteed at the end) */ 
/* Do write through caching */ 


/* Flag values accessible only to open(2) */ 

#define 0_CREAT 00400 /* Open with file create (uses third open arg)*/ 

#define 0_TRUNC 01000 /* Open with truncation */ 

#define O—EXCL 02000 /* Exclusive open */ 


/* fcntl (2) requests */ 
#define F_DUPFD 0 

#define F_GETFD 1 

#define F_SETFD 2 

#defineF_GETFL 3 
#define F_SETFL 4 


/* Duplicate hides */ 
/* Get hides flags */ 
/* Set hides flags */ 
/* Get file flags */ 

/* Set file flags */ 


SEE ALSO 

fcntl(2), open(2). 
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NAME 

hier - file system hierarchy 
DESCRIPTION 

The following outline gives a quick tour through a representative HP-UX directory hierarchy. 
Some of the directories listed only appear with HP-UX versions which support certain optional 
commands or packages which use those directories. Some HP-UX versions add special directories 
not shown here. 

/ Root directory. 

/bin Frequently-used commands and those required to boot, restore, recover, and/or repair 
the system. 

/dev Special files (device files); see mknod{S). 

/etc System administrative commands and configuration files. 

/etc/newconfig 

New (updated) versions of customizable (localizable) configuration files and shell 
scripts. Shipped here so as not to overwrite current versions. Copied to regular loca¬ 
tions for newly installed systems. Administrators may wish to keep them around for 
later reference. 

/lib Frequently-used object code libraries and related utilities. 

/lost 4-found 

For connecting detached files; for use by fsck(S). 

/tmp Place to put temporary files (those normally with short lifetimes and which may be 
removed without notice). 

/users User home directories; sometimes immediate, sometimes at lower levels. 

/users/guest 

Default home directory for user "guest"; see passwd{b). Directory exists for novice 
users; you may wish to remove it. 

/usr Less-frequently-used commands and other miscellaneous things; historically, often a 

separate, mounted volume. 

/usr/adm System-administrative data files. 

/usr/bin Less-frequently-used commands and those not required to boot, restore, recover, 
and/or repair the system. 

/usr/contrib 

User-contributed (unsupported, internal) commands, files, etc. Files under this direc¬ 
tory come from outside the local site or organization, e.g. from users groups, HP ser¬ 
vice engineers, etc. See /usr/local for local-site commands and files. 

/usr/contrib/bin 

User-contributed commands. 

/usr/contrib/games 

User-contributed games. 

/usr/contrib / include 

User-contributed include files. To include them, you must (in C) give a complete 
pathname, for example, ^include "/usr/contrib/include/symtab.h". 

/usr/contrib/lib 

User-contributed libraries. 

/ usr/contrib/man/cat [1-8] 

User-contributed manual entries, post-nroff form. 
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/ usr / contrib / man/man [1-8] 

User-contributed manual entries, pre-nrofF form. 

/usr/contrib / man/$L AN G/cat [1-8] 

User-contributed manual entries, formatted form for installed native languages. The 
LANG environment variable may take on values given in the /usr/lib/nls/config 
table. 

/usr/contrib / man/$L AN G / man [1-8] 

User-contributed manual entries, unformatted form for installed native languages, 
/usr/include 

High-level C-language header files (shared definitions). 

/ usr/include/sys 

Low-level (kernel-related) C-language header files. 

/usr/lib Less-frequently-used object code libraries, related utilities, miscellaneous data files, 
etc. 

/usr/lib/acct 

Certain system-administrative commands. 

/usr/lib/cron 

For cron(l) and a^(l) scheduling information. 

/usr/lib/graphics/c 

Device-independent Graphics Library (DGL) special C-language include files. 
Optional on some systems. 

/usr/lib/graphics/demos 

DGL demonstration software. 

/ usr/lib/graphics/fortran 

DGL special FORTRAN-language include files. 

/ usr/lib/graphics/pascal 

DGL special Pascal-language include files. 

/usr/lib/help 

Data files for help[l). 

/usr/lib/lex 

Data files for lex{l). 

/usr/lib/macros 

Macro definition packages for nroff{l). 

/usr/lib/nls 

native language support 
/usr/lib/nls/config 

correspondence between integer language id and name 
/usr/lib/nls/$LANG 

Language definition (Character Set Support, Local Customs, and Messages) for 
installed native languages. The LANG environment variable may take on values given 
in the /usr/lib/nls/config table. 

/usr/lib/spell 

Data files for spell{l). 

/usr/lib/tabset 

Data files to set tabstops. 
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/usr/lib/term 

Terminal initialization files. 

/usr/lib/tmac 

Macro definition packages for nroJ[f{l). 

/usr/lib/uucp[/*] 

Commands, configuration files, and working directories for uucp{l). 

/usr/local Site-local commands, files, etc. Files under this directory come from inside the local 
site or organization. See /usr/contrib for non-local unsupported commands and files. 

/usr/local/bin 

Site-local commands. 

/usr/local/games 

Site-local games. 

/usr/local/include 

Site-local include files. To include them, you must (in C) give a complete pathname, 
for example, #include "/usr/local/include/symtab.h". 

/usr/local/lib 

Site-local libraries. 

/usr/local/man/cat[l-8] 

Site-local manual entries, post-nroff form. 

/usr/local/man/man[l-8] 

Site-local manual entries, pre-nroff form. 

/usr/local/man/$LANG/cat[l-8] 

Site-local manual entries, unformatted form for installed native languages. The LANG 
environment variable may take on values given in the /usr/lib/nis/config table. 

/usr/local / man/$L AN G/man[l-8] 

Site-local manual entries, formatted form for installed native languages. 

/usr/mail User mailboxes. 

/usr/man On-line documentation. 

/usr/man/cat[l-8] 

Optional formatted (post-nroff) versions of on-line documentation for use by man(l). 
/usr/man/man[l-8] 

Unformatted (pre-nroff) versions of on-line documentation for use by man(l). 
/usr/man/$LANG 

On-line documentation for installed native languages. The LANG environment vari¬ 
able may take on values given in the /usr/lib/nls/config table. 

/usr/man/$LANG/cat[l-8] 

Formatted native language versions of on-line documentation for use by mon(l). 
/usr/man/$LANG/man[l-8] 

Unformatted native language versions of on-line documentation for use by man[l). 
/usr/news Local-system news articles for news{l). 

/usr/preserve 

Place where ex{l) and w(l) save lost edit sessions until recovered. 

/usr/spool Spooled (queued) files for various programs. 

/usr/spool/cron 

Spooled jobs for cron[l) and a^(l). 
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/usr/spool / cron/atjobs 

Spooled jobs for at[l). 

/usr/spool/lp 

Control and working files for lp{l). 

/usr/spool/Ip/class 

Printer class definition files. 

/usr / spool/Ip / interface 

Printer interface shell scripts. 

/usr / spool/Ip/member 

Printer class member definition files. 

/ usr/spool/Ip/request 

Spool directories for each logical destination. 

/ usr/spool/uucp 

Queued work, lockfiles, logfiles, status files, and other files for uucp{l). 

/usr/spool/uucppublic[/*] 

Publicly-accessible directory for use with uucp{l). 

/usr/src Source files. Only present on HP-UX implementations which support source, 
/usr/src/cmd/* 

Source for commands. Simple command sources reside at the top level. Subdirectories 
are named after specific commands, e.g. /usr/src/cmd/cc, and contain the source for 
multi-file or otherwise complicated commands. Directory structure below here 
depends on the individual command; see the associated makefiles. 

/usr/src/games/* 

Source for games. Simple game sources reside at the top level. Subdirectories are 
named after specific games, e.g. /usr/src/games/master^ and contain the source for 
multi-file or otherwise complicated games. Directory structure below here depends on 
the individual game; see the associated makefiles. 

/usr/src/head 

Include files which are copied into /usr/include /*. 

/usr/src/lib 

Source for libraries, in many subdirectories. 

/usr/src/lib/libF77 

Source for FORTRAN-77 miscellaneous (mostly math) libraries. 

/usr/src/lib/iibI77 

Source for FORTRAN-77 I/O libraries. 

/usr/src/lib/libPW 

Source for Programmer’s Workbench libraries. 

/usr/src/lib/libc 

Source for standard C libraries. 

/usr/src/lib/libcurses / * 

Source for curses (cursor control) libraries. 

/usr/src/lib/libl 

Source for lex(l) libraries. 

/ usr / src/lib/libm 

Source for C math libraries. 
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/usr/src/lib/liby 

Source for yacc(l) libraries. 

/usr/tmp Alternate place to put temporary files; usually used when there may be very many of 
them or if they will be large. 

SEE ALSO 

ls(l), find(l), grep(l), whereis(l), hpnls(7). 

HARDWARE DEPENDENCIES 

Series 500 systems support shared libraries loaded by the kernel at powerup time. They reside in 
the directory /etc/sslibs. 

Some directories include commands or files not supported on all HP-UX implementations. 
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NAME 

hpnls - HP Native Language Support (NLS) Model 

SYNOPSIS 

Is /usr/lib/nls/* 

HP-UX COMPATIBILITY 

Level; HP-UX/STANDARD 

Origin: HP 

DESCRIPTION 

The HP Native Language Support (NLS) model includes several capabilities that reduce or elim¬ 
inate the barriers that would otherwise make HP-UX difficult to use in a non-English language. 
The three main categories, Character Set Support, Local Customs, and Messages, are subdivided 
into smaller categories in order to adequately reflect the extent of the Native Language Support. 

CHARACTER SET SUPPORT - 

A major NLS objective is to provide capabilities for adapting character sequences to local 
language needs. 

CHARACTER CODE SIZE - 

The length of the character code governs the number of distinct characters that can be 
included in the character set. 

7- BIT - The ASCII character set consists of 33 control characters including DEL, space, and 

94 printable characters. (See ascii(7).) This is sufficient to span the Latin alphabet, 
upper and lowercase, plus punctuation and special symbols. Seven bits of informa¬ 
tion is sufficient to distinguish the characters in such a set. 

8- BIT - The use of an 8 bit character code allows 67 control codes, space, and 188 printable 

characters. In the case of European characters, this provides sufficient space for 
accented vowels, consonants with special forms, and other special symbols. (See 
roman8(7)). This is also sufficient to hold the phonetic Japanese character set Kata- 
kana. (See kana8(7).) 

16-BIT - 

A number of languages have very large character sets that require more than the 
188 printable characters provided by the 8-bit character codes. Sixteen-bit charac¬ 
ter codes are available for these languages. To simplify processing, 16-bit printable 
characters are formed from pairs of 8-bit printable characters (neither byte may 
contain a control code or a space). This allows representation of up to 35344 char¬ 
acters. 

CHARACTER TYPING - 

Character processing which depends on character type must take into account the character 
type changes that vary with the character set being used. For example, an alphabetic char¬ 
acter in the ROMANS character set may align with a punctuation character in the KANA8 
set. 

SHIFTING - 

While the ROMAN8 character set has uppercase and lowercase for most alphabetic charac¬ 
ters, some languages discard accents when characters are shifted to uppercase. Other alpha¬ 
betic characters may not be shifted at all, when there is no notion of "case" in the underly¬ 
ing language. 

COLLATING - 

The ASCII collation order, while generally tolerated, is not adequate for American diction¬ 
ary usage. Different languages sort characters from the ROMANS set in different orders. 
Some languages require that character pairs, such as "ch" and "11" in Spanish, be sorted as 
single characters. Ideographic character sets may have multiple orderings. For example. 
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Japanese kanjis may be sorted in phonetic order; in a different order based on the number of 
strokes in the ideogram; or according, first, to the radical (root) of the character and, 
second, to the number of strokes added to the radical. 

DIRECTIONALITY - 

The assumption that displayed text goes from left to right does not hold for all languages. 
Some Middle Eastern languages go from right to left. Far Eastern languages usually use 
vertical columns, starting from the right. 

CODING SCHEME CONSIDERATIONS - 

Although most HP supported 8-bit character sets preserve the ASCII codes in the range of 0 
to 127, 16-bit character sets may use these byte values in 2-byte characters. Software that 
assigns special meaning to bytes (metacharacters) in this range must distinguish between 
1-byte and 2-byte characters. In multilingual environments, standard escape code sequences 
are used to indicate change to alternate character sets. Since these sequences are not usu¬ 
ally printed or displayed, the number of characters output is usually less than the number of 
bytes in the sequence. Any software that must locate a character within a sequence must 
accommodate this. 

LOCAL CUSTOMS - 

Some aspects of Native Language Support relate more to local customs of a particular geographic 
location than to the characters used to write the language. 

REPRESENTATION OF NUMBERS - 

The character used to denote the radix of a decimal number varies for different 
regions. Similarly the use of a "thousands" indicator or grouping of (usually three) 
digits may vary with local custom. 

CURRENCY REPRESENTATION - 

The symbol for currency varies from country to country. The symbol may either 
precede or follow the numeric value. Some currencies allow decimal fractions while 
others use alternate methods of representing smaller monetary values. 

DATE AND TIME REPRESENTATION - 

Month and weekday names vary with language (if they are not omitted entirely). 
Abbreviations may be other than three characters, or may not be allowed at all. 
Even when a strictly numeric representation is used, the order of year, month, and 
day as well as the delimiters which separate them is not universal. 

DATE AND TIME ADJUSTMENTS - 

The HP-UX system clock runs on Greenwich Mean Time (GMT). Corrections to 
local time zones consist of adding or subtracting whole or fractional hours from 
GMT. The Gregorian calendar is most common, but some locales use different 
methods for determining meridian day and year; usually based on seasonal, astro¬ 
nomical, or historical events. 

MESSAGES - 

The need for messages to be readable by users is perhaps the most significant justification for 
implementing Native Language Support. 

MESSAGE CONTENT - 

Error messages, prompts, expected responses, and mnemonic command names 
should be based on the user’s native language. 

MESSAGE STRUCTURE - 

Messages must often be built from segments. To accommodate grammatical 
differences, it may be necessary to change the order in which the fragments are con¬ 
nected. 
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EXAMPLE 

A "fully localized" version of "pr" would 

Never strip the 8th bit of a character code. 

Properly format the date in each page header. 

Use the message catalog system to select user error messages. 

FILES 

/usr/lib/nls/* 

SEE ALSO 

date(l), sort(l), ctime(3C), ecvt(3C), getmsg(3C), langinfo(3C), nl_conv(3C), nl_ctype(3C), 
nl_string(3C), printmsg(3C), strtod(3C), ascii(7), kana8(7), roman8(7). 


Hewlett-Packard 


-3- 


July 9, 1985 



KANA8(7) 


KANA8(7) 


NAME 

kanaS - map of KANA8 character set used by NLS 

SYNOPSIS 

Is /usr/lib/nls/* 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

DESCRIPTION 

KanaS is a map of the KANAS character set, giving the octal, decimal, and hexadecimal 
equivalents of each character, to be printed as needed. It contains: 


000 

0 

00 

nul 

001 

1 

01 

soh 

002 

2 

02 

six 

003 

3 

03 

et X 

004 

4 

04 

eot 

005 

5 

05 

enq 

006 

6 

06 

ack 

007 

7 

07 

be 1 

010 

8 

08 

bs 

Oil 

9 

09 

ht 

012 

10 

Oa 

nl 

013 

11 

Ob 

vt 

014 

12 

Oc 

np 

015 

13 

Od 

cr 

016 

14 

Oe 

so 

017 

15 

Of 

s i 

020 

16 

10 

die 

021 

17 

11 

del 

022 

18 

12 

dc2 

023 

19 

13 

dc3 

024 

20 

14 

dc4 

025 

21 

15 

nak 

026 

22 

16 

syn 

027 

23 

17 

etb 

030 

24 

18 

can 

031 

25 

19 

e-m 

032 

26 

la 

sub 

033 

27 

lb 

esc 

034 

28 

Ic 

f s 

035 

29 

Id 

gs 

036 

30 

le 

rs 

037 

31 

If 

as 

040 

32 

20 

sp 

041 

33 

21 

j 

042 

34 

22 

II 

043 

35 

23 


044 

36 

24 

$ 

045 

37 

25 


046 

38 

26 

& 

047 

39 

27 

1 

050 

40 

23 

C 

051 

41 

29 

) 

052 

42 

2a 

★ 

053 

43 

2b 

+ 

054 

44 

2c 


055 

45 

2d 

- 

056 

46 

2e 


057 

47 

2f 

/ 

060 

48 

30 

0 

061 

49 

31 

1 

062 

50 

32 

2 

063 

51 

33 

3 

064 

52 

34 

4 

065 

53 

35 

5 

066 

54 

36 

6 

067 

55 

37 

7 

070 

56 

38 

8 

071 

57 

39 

9 

072 

58 

3a 

I 

073 

59 

3b 


074 

60 

3c 

< 

075 

61 

3d 


076 

62 

3e 

y 

077 

63 

3f 

? 

100 

64 

40 

@ 

101 

65 

41 

P 

102 

66 

42 

B 

103 

67 

43 

C 

104 

68 

44 

D 

105 

69 

45 

E 

106 

70 

46 

F 

_1 

107 

71 

47 

G 
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110 

72 

48 

H 



111 

73 

49 

I 

112 

74 

4a 

J 



113 

75 

4b 

K 

114 

76 

4c 

L 



115 

77 

4d 

M 

116 

78 

4e 

N 



117 

79 

4f 

0 

120 

80 

50 

P 



121 

81 

51 

Q 

122 

82 

52 

R 



123 

83 

53 

S 

124 

84 

54 

T 



125 

85 

55 

U 

126 

86 

56 

U 



127 

87 

57 

y 

130 

88 

58 

X 



131 

89 

59 

Y 

132 

90 

5a 

Z 



133 

91 

5b 

c 

134 

92 

5c 

¥ 

yon 


135 

93 

5d 

3 

136 

94 

5e 

/s 


137 

95 

5f 


140 

96 

60 

V 



141 

97 

61 

a 

142 

98 

62 

b 



143 

99 

63 

c 

144 

100 

64 

d 



145 

101 

65 

e 

146 

102 

66 

f 



147 

103 

67 

g 

150 

104 

68 

h 



151 

105 

69 

i 

152 

106 

6a 

j 



153 

107 

6b 

k 

154 

108 

6c 

1 



155 

109 

6d 

m 

156 

110 

6e 

n 



157 

111 

6f 

O 

160 

112 

70 

P 



161 

113 

71 

q 

162 

114 

72 

r 



163 

115 

73 

s 

164 

116 

74 

t 



165 

117 

75 

Q 

166 

118 

76 

V 



167 

119 

77 

eg 

170 

120 

78 

X 



171 

121 

79 

y 

172 

122 

7a 

z 



173 

123 

7b 

< 

174 

124 

7c 

1 



175 

125 

7d 

> 

176 

126 

7e 

rv 



177 

127 

7f 

del 

200 

128 

80 




201 

129 

81 


202 

130 

82 




203 

131 

83 


204 

132 

84 




205 

133 

85 


206 

134 

86 




207 

135 

87 


210 

136 

83 




211 

137 

89 


212 

138 

3a 




213 

139 

8b 


214 

140 

8c 




215 

141 

8d 


216 

142 

8e 

562 


217 

143 

8f 

ss3 

220 

144 

90 




221 

145 

91 


222 

146 

92 




223 

147 

93 


224 

148 

94 




225 

149 

95 


226 

150 

96 




227 

151 

97 


230 

152 

98 




231 

153 

99 


232 

154 

9a 




233 

155 

9b 


234 

156 

9c 




235 

157 

9d 


236 

158 

9e 




237 

159 

9f 


240 

160 

aO 




241 

161 

al 

• ku~ten 

242 

162 

a2 

r 

hook 


243 

163 

a3 

J unhook 

244 

164 

a4 


to-ten 

245 

165 

a5 

* dot 

246 

166 

a6 


WPO 


247 

167 

a7 

7 small a 

250 

168 

a8 

i 

small 

i 

251 

169 

a9 

0 small u 

252 

170 

aa 

1 

small 

e 

253 

171 

ab 

small o 

254 

172 

ac 

1> 

small 

ya 

255 

173 

ad 

2 . small yu 

256 

174 

ae 

3 

small 

yo 

257 

175 

af 

•y small tsu 
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260 

176 

bO 


dash 

261 

177 

bl 

7 

a 

262 

178 

b2 


i 

263 

179 

b3 

9 

u 

264 

180 

b4 

I 

e 

265 

181 

b5 


0 

266 

182 

b6 

n 

ka 

267 

183 

b7 

f 

ki 

270 

184 

b8 

9 

ku 

271 

185 

b9 


ke 

272 

186 

ba 

□ 

ko 

273 

187 

bb 

tr 

sa 

274 

188 

be 


shi 

275 

189 

bd 

7 

SQ 

276 

190 

be 


se 

277 

191 

bf 

V 

so 

300 

192 

cO 

9 

ta 

301 

193 

cl 


chi 

302 

194 

c2 

'!? 

tSQ 

303 

195 

c3 


te 

304 

196 

c4 

h 

to 

305 

197 

c5 

9 

na 

306 

198 

c6 

" 

ni 

307 

199 

c7 

7 

na 

310 

200 

c8 

2 

ne 

311 

201 

c9 

j 

no 

312 

202 

ca 

A 

ba 

313 

203 

cb 

t 

hi 

314 

204 

cc 

9 

fQ 

315 

205 

cd 


he 

316 

206 

ce 

5K 

ho 

317 

207 

cf 

7 

ma 

320 

208 

dO 


mi 

321 

209 

dl 


mu 

322 

210 

d2 


me 

323 

211 

d3 


mo 

324 

212 

d4 

V 

ya 

325 

213 

d5 

1 

ya 

326 

214 

d6 

3 

yo 

327 

215 

d7 

5 

ra 

330 

216 

d8 

•J 

r i 

331 

217 

d9 

h 

ra 

332 

218 

da 

b 

re 

333 

219 

db 

Q 

ro 

334 

220 

dc 

9 

wa 

335 

221 

dd 

~J 

n 

336 

222 

de 

II 

voiced 

337 

223 

df 

0 

degree 

340 

224 

eO 



341 

225 

el 


342 

226 

e2 



343 

227 

e3 



344 

228 

e4 



345 

229 

©5 



346 

230 

e6 



347 

231 

e7 



350 

232 

08 



351 

233 

e9 



352 

234 

ea 



353 

235 

eb 



354 

236 

ec 



355 

237 

ed 



356 

238 

ee 



357 

239 

e f 



360 

240 

fO 



361 

241 

f 1 



362 

242 

f2 



363 

243 

f3 



364 

244 

f4 



365 

245 

f5 



366 

246 

f6 



367 

247 

f 7 



370 

248 

f8 



371 

249 

f9 



372 

250 

fa 



373 

251 

fb 



374 

252 

f c 



375 

253 

fd 



376 

254 

f e 



377 

255 

f f 




FILES 

/usr/lib/nls/* 

SEE ALSO 

ascii(7), hpnls(7), roman8(7). 

WARNINGS 

Peripheral or software limitations may garble this manual page. Many printers and terminals do 
not support the KANA8 character set. 
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NAME 

langid - language identification variable used with NLS 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

DESCRIPTION 

This page defines integer values corresponding to values of the variable LANG in the user’s 
environment. These are the values returned by currlangid(3C) , and are pgissed as parameters 
into native language support library routines. 

LANGUAGE NAMES 

The following languages are currently supported by HP-UX. 

Language 


Num 

Abbreviation 

Name 

00 

n-computer 

native computer 

01 

american 

american 

02 

c-french 

Canadian french 

03 

danish 

danish 

04 

dutch 

dutch 

05 

english 

english 

06 

finnish 

finnish 

07 

french 

french 

08 

german 

german 

09 

italian 

italian 

10 

norwegian 

norwegian 

11 

Portuguese 

Portuguese 

12 

Spanish 

Spanish 

13 

Swedish 

Swedish 

14-40 

reserved 


41 

katakana 

katakana 

42-80 

reserved 



SEE ALSO 

langinfo(3C), environ(7), hier(7), hpnls(7). 

BUGS 

Currently only supported in ’sh’. 
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NAME 

man - macros for formatting entries in this manual 

SYNOPSIS 

nroff -man files 

HP-UX COMPATIBILITY 

Level; Text Processing - HP-UX/STANDARD 

Origin: System V 
DESCRIPTION 

These nroff{l) macros are used to lay out the format of the entries of this manual. These macros 
are used by the man(l) command. 

The default page size is 8.5"x 11", with a 6.5"x 10" text area. The -rV2 option may be used to 
set certain parameters to values appropriate for certain Versatec printers: it sets the line length 
to 82 characters, the page length to 84 lines, and it inhibits underlining. 

Any text argument below may be one to six “words”. Double quotes ("") may be used to include 
blanks in a “word”. If text is empty, the special treatment is applied to the next line that con¬ 
tains text to be printed. For example, .1 may be used to italicize a whole line, or .SM followed by 
.B to make small bold text. By default, hyphenation is turned off. 

Type font and size are reset to default values before each paragraph and after processing font- 
and size-setting macros, e.g., .1, .RB, .SM. Tab stops are neither used nor set by any macro 
except .DT and .TH. 

Default units for indents in are ens. When in is omitted, the previous indent is used. This 
remembered indent is set to its default value (5 ens in nr off-this corresponds to 0.5" in the default 
page size) by .TH, .P, and .RS, and restored by .RE. 

.TH t s c n Set the title and entry heading; t is the title, s is the section number, c is extra com¬ 
mentary, e.g., “local”, n is new manual name. Invokes .DT (see below). 

.SH text Place subhead text, e.g., SYNOPSIS, here. 

.SS text Place sub-subhead text, e.g.. Options, here. 

.B text Make text bold. 

.1 text Make text italic. 

.SM text Make text 1 point smaller than default point size. 

.RI a b Concatenate roman a with italic b, and alternate these two fonts for up to six argu¬ 
ments. Similar macros alternate between any two of roman, italic, and bold: 

.IR .RB .BR .IB .BI 

.P Begin a paragraph with normal font, point size, and indent. .PP is a synonym for .P. 

.HP in Begin paragraph with hanging indent. 

.TP in Begin indented paragraph with hanging tag. The next line that contains text to be 
printed is taken as the tag. If the tag does not fit, it is printed on a separate line. 

.IP t in Same as .TP in with tag t; often used to get an indented paragraph without a tag. 

.RS in Increase relative indent (initially zero). Indent all output an extra in units from the 

current left margin. 

.RE k Return to the kth relative indent level (initially, k=l’, k=0 is equivalent to k=l); if k 
is omitted, return to the most recent lower indent level. 

.PM m Produces proprietary markings; where m may be P for PRIVATE, or N for 
NOTICE. 

.DT Restore default tab settings (every 5 ens in nroff). 

.PD V Set the interparagraph distance to v vertical spaces. If v is omitted, set the inter¬ 
paragraph distance to the default value (Iv in nroff). 

The following strings are defined: 
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\*R “(Reg.)” in nroff. 

\*S Change to default type size. 

\*(Tm Trademark indicator. 

The following number registers are given default values by .TH: 

IN Left margin indent relative to subheads (default is 5 ens in nr off). 

LL Line length including IN. 

PD Current interparagraph distance. 

CAVEATS 

In addition to the macros, strings, and number registers mentioned above, there are defined a 
number of internal macros, strings, and number registers. Except for names predefined by nr off 
and number registers d, m, and y, all such internal names are of the form XA, where X is one of 
), ], and }, and A stands for any alphanumeric character. 

If a manual entry needs to be preprocessed by tbl{l), it must begin with a special line (described 
in man(l)), causing the man command to invoke the appropriate preprocessor(s). 

The programs that prepare the Table of Contents and the Permuted Index for this Manual 
assume the NAME section of each entry consists of a single line of input that has the following 
format: 

name[, name, name ...] \- explanatory text 

The macro package increases the inter-word spaces (to eliminate ambiguity) in the SYNOPSIS 
section of each entry. 

The macro package itself uses only the roman font (so that one can replace, for example, the bold 
font with a different font). Of course, if the input text of an entry contains requests for other 
fonts (e.g., .1, .RB, \fl), the corresponding fonts must be mounted. 

FILES 

/ usr/lib/tmac/tmac. an 
/usr/lib/macros/cmp.n. [dt] .an 
/usr/lib/macros/ucmp.n.an 

SEE ALSO 

man(l), nroff(l). 

BUGS 

If the argument to .TH contains any blanks and is not enclosed by double quotes (""), the output 
can be incorrectly formatted. 
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NAME 

math - math functions and constants 
SYNOPSIS 

#include <math.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

This file contains declarations of all the functions in the Math Library (described in Section 3M), 
as well as various functions in the C Library (Section 3C) that return floating-point values. 

It defines the structure and constants used by the matherr(SM) error-handling mechanisms, 
including the following constant used as an error-return value: 

HUGE The maximum value of a single-precision floating-point number. 

MAXFLOAT The maximum value of a single-precision floating-point number. 

For the definitions of various machine-dependent “constants,” see the description of the 
<values.h> header file. 

FILES 

/usr/include/math.h 
SEE ALSO 

intro(3), matherr(3M), values(7). 
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NAME 

mm - the MM macro package for formatting documents 
SYNOPSIS 

mm [ options ] [ files ] 
nroff -mm [ options ) [ files ] 
nroff -cm [ options ] [ files ] 

HP-UX COMPATIBILITY 

Level: Text Processing - HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

This package provides a formatting capability for a very wide variety of documents. The manner 
in which a document is typed in and edited is essentially independent of whether the document is 
to be eventually formatted at a terminal or is to be phototypeset. See the references below for 
further details. 


The -mm option causes nroff and troff{l) to use the non-compacted version of the macro pack¬ 
age, while the -cm option results in the use of the compacted version, thus speeding up the pro¬ 
cess of loading the macro package. 


FILES 

/ usr/lib/tmac/tmac .m 
/usr/lib/macros/mmn 
/usr/lib/macros/cmp .n. [dt] .m 
/ usr/lib/macros/ucmp. [nt] .m 


pointer to the non-compacted version of the package 
non-compacted version of the package 
compacted version of the package 
initializers for the compacted version of the package 


SEE ALSO 

mm(l), nroff(l). 

MM-Memorandum Macros in HP-UX Concepts and Tutorials. 

HARDWARE DEPENDENCIES 

Compacted macros are not suppoprted on Series 500 implementations. 
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NAME 

INIT, GETC, PEEKC, UNGETC, RETURN, ERROR, compile, step, advance - regular expres¬ 
sion compile and match routines 

SYNOPSIS 

#define INIT <declarations> 

#define GETC() <getc code> 

#define PEEKC () <peekc code> 

#define UNGETC(c) <imgetc code> 

#define RETURN(pointer) <retum code> 

#define ERROR (val) <error code> 

#include <regexp.h> 

char *compile (instring, expbuf, endbuf, eof) 
char *instring, *expbuf, *endbuf; 
int eof; 

int step (string, expbuf) 
char *string, *expbuf; 

int advance (string, expbuf) 
char *string, *expbuf; 

extern char *locl, *loc2, *locs; 
extern int circf, sed, nbra; 


HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System III 


DESCRIPTION 

This page describes general-purpose regular expression matching routines in the form of ed(l), 
defined in /usr/include/regexp.h. Programs such as ed(l), sed(l), grep{l), 6s(l), expr{l), etc., 
which perform regular expression matching use this source file. In this way, only this file need be 
changed to maintain regular expression compatibility. 


The interface to this file is complex. Programs that include this file must have the following five 
macros declared before the “#include <regexp.h>” statement. These macros are used by the 
compile routine. 


GETC() 


PEEKC () 


UNGETC(c) 


RETURN (powder) 


ERROR (?;a/) 


Return the value of the next character in the regular expression pattern. 
Successive calls to GETC() should return successive characters of the regu¬ 
lar expression. 

Return the next character in the regular expression. Successive calls to 
PEEKC() should return the same character (which should also be the next 
character returned by GETC()). 

Cause the argument c to be returned by the next call to GETC() (and 
PEEKC()). No more than one character of pushback is ever needed and 
this character is guaranteed to be the last character read by GETC(). The 
value of the macro UNGETC(c) is always ignored. 

This macro is used on normal exit of the compile routine. The value of the 
argument pointer is a pointer to the character after the last character of 
the compiled regular expression. This is useful to programs which have 
memory allocation to manage. 

This is the abnormal return from the compile routine. The argument val is 
an error number (see table below for meanings). This call should never 
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return. 


ERROR 

MEANING 

11 

Range endpoint too large. 

16 

Bad number. 

25 

“\digit” out of range. 

36 

Illegal or missing delimiter. 

41 

No remembered search string. 

42 

\( \) imbalance. 

43 

Too many \(. 

44 

More than 2 numbers given in \{ \}. 

45 

} expected after \. 

46 

First munber exceeds second in \{ \} 

49 

[ ] imbalance. 

50 

Regular expression overflow. 


The syntax of the compile routine is as follows: 
compile (instring, expbuf, endbuf, eof) 

The first parameter instring is never used explicitly by the compile routine but is useful for pro¬ 
grams that pass down different pointers to input characters. It is sometimes used in the INIT 
declaration (see below). Programs which call functions to input characters or have characters in 
an external array can pass down a value of ((char *) 0) for this parameter. 

The next parameter expbuf is a character pointer. It points to the place where the compiled regu¬ 
lar expression will be placed. 

The parameter endbuf is one more than the highest address that the compiled regular expression 
may occupy. If the compiled expression cannot fit in {endbuf-expbuf) bytes, a call to ERROR(50) 
is made. 

The parameter eof is the character which marks the end of the regular expression. For example, 
in ec?(l), this character is usually a /. 

Each program that includes this file must have a #define statement for INIT. This definition will 
be placed right after the declaration for the function compile and the opening curly brace ({). It 
is used for dependent declarations and initializations. Most often it is used to set a register vari¬ 
able to point to the beginning of the regular expression so that this register variable can be used 
in the declarations for GETC(), PEEKC() and UNGETC(). Otherwise it can be used to declare 
external variables that might be used by GETC(), PEEKC() and UNGETC(). See the example 
below of the declarations taken from grep{l). 

There are other functions in this file which perform actual regular expression matching, one of 
which is the function step. The call to step is as follows: 

step(string, expbuf) 

The first parameter to step is a pointer to a string of characters to be checked for a match. This 
string should be null terminated. 

The second parameter expbuf is the compiled regular expression which was obtained by a call of 
the function compile. 

The function step returns non-zero if the given string matches the regular expression, and zero if 
the expressions do not match. If there is a match, two external character pointers are set as a 
side effect to the call to step. The variable set in step is loci. This is a pointer to the first char¬ 
acter that matched the regular expression. The variable loc2, which is set by the function 
advance, points to the character after the last character that matches the regular expression. 
Thus if the regular expression matches the entire line, loci will point to the first character of 
string and loc2 will point to the null at the end of string. 
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Step uses the external variable circf which is set by compile if the regular expression begins with 
If this is set then step will try to match the regular expression to the beginning of the string 
only. If more than one regular expression is to be compiled before the first is executed the value 
of circf should be saved for each compiled expression and circf should be set to that saved value 
before each call to step. 

The function advance is called from step with the same arguments as step. The purpose of step is 
to step through the string argument and call advance until advance returns non-zero indicating a 
match or until the end of string is reached. If one wants to constrain string to the beginning of 
the line in all cases, step need not be called; simply call advance. 

When advance encounters a * or \{ \} sequence in the regular expression, it will advance its 
pointer to the string to be matched as far as possible and will recursively call itself trying to 
match the rest of the string to the rest of the regular expression. As long as there is no match, 
advance will back up along the string until it finds a match or reaches the point in the string that 
initially matched the * or \{ \}. It is sometimes desirable to stop this backing up before the ini¬ 
tial point in the string is reached. If the external character pointer Iocs is equal to the point in 
the string where the match first occurred at sometime during the backing up process, advance will 
break out of the loop that backs up and will return zero. This is used by ed{l) and sed{l) for 
substitutions done globally (not just the first occurrence, but the whole line) so, for example, 
expressions like s/y*//g do not loop forever. 

The additional external variables sed and nbra are used for special purposes. 

EXAMPLES 

The following is an example 
sion of grep(l): 

#define INIT 
#define GETC() 

#define PEEKC() 

#define UNGETC(c) 

#define RETURN(c) 

#define ERROR(c) 

^include <regexp.h> 

(void) compile (^argv, expbuf, &:expbuf[ESIZE], /\0/); 

if (step(linebuf, expbuf)) 
succeed( ); 

FILES 

/usr / include/regexp. h 
SEE ALSO 

bs(l), ed(l), expr(l), grep(l), sed(l). 

BUGS 

The handling of circf is poor. 

The actual code is probably easier to understand than this manual page. 


of how the regular expression macros and calls look from an old ver- 

register char *sp = instring; 

(*sp++) 

(*sp) 

(-sp) 
return; 
regerr() 
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NAME 

romanS - map of ROMANS character set used by NLS 

SYNOPSIS 

Is /usr/lib/nls/* 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

DESCRIPTION 

Romans is a map of the ROMANS character set, giving the octal, decimal, and hexadecimal 
equivalents of each character, to be printed as needed. It contains: 


000 

0 

00 

nul 

001 

1 

01 

soh 

002 

2 

02 

stx 

003 

3 

03 

etx 

004 

4 

04 

eot 

005 

5 

05 

enq 

006 

6 

06 

ack 

007 

7 

07 

bel 

010 

8 

08 

bs 

Oil 

9 

09 

ht 

012 

10 

Oa 

nl 

013 

11 

Ob 

vt 

014 

12 

Oc 

np 

015 

13 

Od 

cr 

016 

14 

Oe 

so 

017 

15 

Of 

s 1 

020 

16 

10 

die 

021 

17 

11 

del 

022 

18 

12 

dc2 

023 

19 

13 

dc3 

024 

20 

14 

dc4 

025 

21 

15 

nak 

026 

22 

16 

syn 

027 

23 

17 

etb 

030 

24 

18 

can 

031 

25 

19 

em 

032 

26 

la 

sub 

033 

27 

lb 

esc 

034 

28 

Ic 

f s 

035 

29 

Id 

gs 

036 

30 

le 

r s 

037 

31 

If 

us 

040 

32 

20 

sp 

041 

33 

21 

f 

042 

34 

22 


043 

35 

23 

# 

044 

36 

24 

$ 

045 

37 

25 

% 

046 

38 

26 

& 

047 

39 

27 

• 

050 

40 

28 

( 

051 

41 

29 

) 

052 

42 

2 a 

* 

053 

43 

2 b 

+ 

054 

44 

2 c 

} 

055 

45 

2 d 


056 

46 

2 e 


057 

47 

2 f 

/ 

060 

48 

30 

0 

061 

49 

31 

1 

062 

50 

32 

2 

063 

51 

33 

3 

064 

52 

34 

4 

065 

53 

35 

5 

066 

54 

36 

6 

067 

55 

37 

7 

070 

56 

38 

8 

071 

57 

39 

9 

072 

58 

3a 

: 

073 

59 

3b 

f 

074 

60 

3c 

< 

075 

61 

3d 


076 

62 

3e 

> 

077 

63 

3f 

•? 

100 

64 

40 


101 

65 

41 

A 

102 

66 

42 

B 

103 

67 

43 

C 

104 

68 

44 

D 

105 

69 

45 

E 

106 

70 

46 

F 

107 

71 

47 

G 


Hewlett-Packard 


- 1 - 


July 11, 1985 





ROMANS (7) 


ROMANS (7) 


110 

72 

48 

H 


111 

73 

49 

I 


112 

74 

4a 

J 


113 

75 

4b 

K 


114 

76 

4c 

L 


115 

77 

4d 

M 


116 

78 

4e 

N 


117 

79 

4f 

0 


120 

80 

50 

P 


121 

81 

51 

Q 


122 

82 

52 

R 


123 

83 

53 

S 


124 

84 

54 

T 


125 

85 

55 

u 


126 

86 

56 

V 


127 

87 

57 

w 


130 

88 

58 

X 


131 

89 

59 

Y 


132 

90 

5a 

z 


133 

91 

5b 

c 


134 

92 

5c 

\ 


135 

93 

5d 

] 


136 

94 

5e 



137 

95 

5f 



140 

96 

60 



141 

97 

61 

a 


142 

98 

62 

b 


143 

99 

63 

c 


144 

100 

64 

d 


145 

101 

65 

e 


146 

102 

66 

f 


147 

103 

67 

g 


150 

104 

68 

h 


151 

105 

69 

i 


152 

106 

6a 

j 


153 

107 

6b 

k 


154 

108 

6c 

1 


155 

109 

6d 

m 


156 

110 

6e 

n 


157 

111 

6f 

o 


160 

112 

70 

P 


161 

113 

71 

q 


162 

114 

72 

r 


163 

115 

73 

s 


164 

116 

74 

t 


165 

117 

75 

u 


166 

118 

76 

V 


167 

119 

77 

w 


170 

120 

78 

X 


171 

121 

79 

Y 


172 

122 

7a 

z 


173 

123 

7b 

< 


174 

124 

7c 

1 


175 

125 

7d 

> 


176 

126 

7e 

- 


177 

127 

7f 

del 

200 

128 

80 



201 

129 

81 



202 

130 

82 



203 

131 

83 



204 

132 

84 



205 

133 

85 



206 

134 

86 



207 

135 

87 



210 

136 

88 



211 

137 

89 



212 

138 

8a 



213 

139 

8b 



214 

140 

8c 



215 

141 

8d 



216 

142 

8e 

ss2 

217 

143 

8f 

ss3 

220 

144 

90 



221 

145 

91 



222 

146 

92 



223 

147 

93 



224 

148 

94 



225 

149 

95 



226 

150 

96 



227 

151 

97 



230 

152 

98 



231 

153 

99 



232 

154 

9a 



233 

155 

9b 



234 

156 

9c 



235 

157 

9d 



236 

158 

9e 



237 

159 

9f 



240 

160 

aO 



241 

161 

al 

A 

A accent grave 

242 

162 

a2 

fk 

A circumflex 

243 

163 

a3 

k 

E accent grave 

244 

164 

a4 


E circumflex 

245 

165 

a5 

E 

E umlaut 

246 

166 

a6 

± 

I circumflex 

247 

167 

a7 

± 

I umlaut 

250 

168 

a8 


accent acute 

251 

169 

a9 


accent grave 

252 

170 

aa 


circumflex 

253 

171 

ab 

•• 

umlaut accent 

254 

172 

ac 


tilde accent 

255 

173 

ad 

0 

U accent grave 

256 

174 

ae 

0 

U circumflex 

257 

175 

af 

£ 

Italian lira 
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260 

176 

bO 

- 

over line 

261 

177 

bl 




262 

178 

b2 




263 

179 

b3 

• 

degree 

264 

180 

b4 


C 

cedilla 

265 

181 

b5 

9 

c 

cedilla 

266 

182 

b6 


N 

tilde 

267 

183 

b7 

Pi 

n 

tilde 

270 

184 

b8 

1 

inv. exclamation 

271 

185 

b9 

6 

inv. question 

272 

186 

ba 

a 

general currency 

273 

187 

bb 

£ 

British pound 

274 

188 

be 

¥ 

Japanese yen 

275 

189 

bd 

§ 

section 

276 

190 

be 

f 

Dutch guilder 

277 

191 

bf 

C 

U. 

S- cent 

300 

192 

cO 

Si 

a 

circumflex 

301 

193 

cl 

§ 

e 

circumflex 

302 

194 

c2 

6 

o 

circumflex 

303 

195 

c3 

Q 

u 

circumflex 

304 

196 

c4 

k 

a 

accent acute 

305 

197 

c5 

k 

e 

accent acute 

306 

198 

c6 

6 

o 

accent acute 

307 

199 

c7 

0 

u 

accent acute 

310 

200 

c8 

k 

a 

accent grave 

311 

201 

c9 

k 

e 

accent grave 

312 

202 

ca 

6 

o 

accent grave 

313 

203 

cb 

a 

u 

accent grave 

314 

204 

cc 

k 

a 

umlaut 

315 

205 

cd 

e 

e 

umlaut 

316 

206 

ce 

6 

o 

umlaut 

317 

207 

cf 

(i 

u 

umlaut 

320 

208 

do 

A 

A 

degree 

321 

209 

dl 

1 

i 

circumflex 

322 

210 

d2 

0 

0 

crossbar 

323 

211 

d3 

/£ 

AE ligature 

324 

212 

d4 

a 

a 

degree 

325 

213 

d5 

i 

i 

accent acute 

326 

214 

d6 

0 

o 

crossbar 

327 

215 

d7 

m 

ae ligature 

330 

216 

d8 

A 

A 

umlaut 

331 

217 

d9 

1 

i 

accent grave 

332 

218 

da 

6 

0 

umlaut 

333 

219 

db 

0 

U 

umlaut 

334 

220 

dc 


E 

accent acute 

335 

221 

dd 

i 

i 

umlaut 

336 

222 

de 


sharp s 

337 

223 

df 

6 

O 

circumflex 

340 

224 

eO 

A 

A 

accent acute 

341 

225 

el 

A 

A 

tilde 

342 

226 

e2 

a 

a 

tilde 

343 

227 

e3 

D 

D 

stroke 

344 

228 

e4 

d 

d 

stroke 

345 

229 

e5 

± 

I 

accent acute 

346 

230 

e6 

± 

I 

accent grave 

347 

231 

e7 

6 

O 

accent acute 

350 

232 

e8 

6 

0 

accent grave 

351 

233 

e9 

a 

0 

tilde 

352 

234 

ea 

5 

o 

tilde 

353 

235 

eb 

s 

S 

caron 

354 

236 

ec 

§ 

s 

caron 

355 

237 

ed 

0 

U 

accent acute 

356 

238 

ee 

Y 

Y 

umlaut 

357 

239 

ef 

y 

Y 

umlaut 

360 

240 

fO 

I> 

THORN 

361 

241 

fl 


thorn 

362 

242 

f 2 




363 

243 

f 3 




364 

244 

f4 




365 

245 

f5 




366 

246 

f6 

- 

long dash 

367 

247 

f7 

i 

one fourth 

370 

248 

f8 

i 

one half 

371 

249 

f9 

a. 

femin. ordinal 

372 

250 

fa 

A 

masc. ordinal 

373 

251 

fb 

« 

open guillemets 

374 

252 

f c 

■ 

solid 

375 

253 

fd 

» 

close guillemets 

376 

254 

fe 

± 

plus/minus 

377 

255 

ff 





FILES 

/usr/lib/nls/* 

SEE ALSO 

ascii(7), hpnls(7), kana8(7). 

WARNINGS 

Peripheral or software limitations may garble this manual page. Some printers and terminals do 
not support the ROMANS character set. 
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NAME 

stat - data returned by stat/fstat system call 

SYNOPSIS 

^include <sys/types.h> 

^include <sys/stat.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System III 

DESCRIPTION 

The system calls stat and fstat{2) return data whose structure is defined by this include file. The 
encoding of the field sL-tnode is defined in this file also. 

r 

* Structure of the result of stat 

7 

struct stat 

{ 

dev_t st_dev; 
ino_t st_ino; 
ushort st_mode; 
short st_nlink; 
ushort st_uid; 
ushort st_gid; 
dev_t st_rdev; 
off_t st_size; 
time_t st_atime; 
time_t st_mtime; 
time_t st_ctime; 

}; 


#define S_IFMT 

0170000 

/ * type of file * / 

#define S_IFDIR 

0040000 

/* directory */ 

#define S_IFCHR 

0020000 

/* character special */ 

#define S_IFBLK 

0060000 

/* block special */ 

#define S_IFREG 

0100000 

/* regular */ 

#define S_IFIFO 

0010000 

/* fifo */ 

#define S_IFNWK 

0110000 

/* network special */ 

#define S_ISUID 

04000 

//* set user id on execution */ 

#define S_ISGID 

02000 

//* set group id on execution */ 

#define S_ISVTX 

01000 

//* save swapped text even after use ♦/ 

#define S_IREAD 

00400 

//* read permission, owner */ 

#define S_IWRITE 

00200 

/ write permission, owner ♦/ 

#define S_IEXEG 

00100 

//* execute/search permission, owner */ 


FILES 

/usr/include/sys/types.h 
/usr/include / sy s/st at. h 

SEE ALSO 

stat (2), types(5). 
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HARDWARE DEPENDENCIES 
Integral PC: 

The S_JFNWK i-node type is not supported. 
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NAME 

term - conventional names for terminals 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System III and UCB 

DESCRIPTION 

The environment variable TERM is used by certain commands (e.g., tabs{l), and is maintained as 
part of the shell environment (see profile(4), and environ{5)) The tset{l) command can be used to 
set the TERM variable When tset is used, the name to which TERM is set must be listed in the 
/terminfo data base (see terminfo(b)). 

hpsub Minimal subset of the capabilities of all Hewlett-Packard terminals and terminal 
emulators supported on both Series 500 and Series 200 HP-UX. 
hp Minimal subset of the capabilities of Hewlett-Packard terminals supported on both 

Series 200 and Series 500 HP-UX (does not include 98x6 Internal Terminal Emula¬ 
tor). 

9836 Internal Terminal Emulator (ITE) for the HP 9000 Models 236 and 220 computers. 

9826 Internal Terminal Emulator (ITE) for the HP 9000 Model 226 computer. 

262x Hewlett-Packard 262x family. Includes the HP 2622, HP 2623, and HP 2624 termi¬ 

nals. 

2622 Hewlett-Packard HP 2622 terminal. 

2623 Hewlett-Packard HP 2623 graphics terminal. 

2624 Hewlett-Packard HP 2624 terminal. 

Other terminal names included in the /terminfo data base do not imply support of those termi¬ 
nals. 

The TERM variable is also used by certain commands (e.g. nroff{l), man(l), tabs{l)), some of 
which use terminal and printer description files from the /usr/lib/terms directory. TERM names 
which have files in this directory include the following (note that the publication of these names 
and presence of these files does not imply support of these devices): 


2631 

Hewlett-Packard 2631 line printer. 

2631-c 

Hewlett-Packard 2631 line printer - compressed mode. 

2631-e 

Hewlett-Packard 2631 line printer - expanded mode. 

300 

DASI/DTC/GSI 300 and others using the Hy Type I printer. 

300-12 

Same as 300, in 12-pitch mode. 

300s 

DASI/DTC/GSI 300s 

300S-12 

Same as 300s, in 12-pitch mode. 

382 

DTC 382. 

37 

TELETYPE Model 27 KSR. 

4000A 

Trendata 4000A. 

450 

DASI 450 (same as Diablo 1620). 

450-12 

Same as 450, in 12-pitch mode. 

Ip 

Generic name for a line printer. 

tn300 

General Electric TermiNet 300. 


A basic terminal name can be up to eight characters chosen from A-Z, a-z, 0-9, and -. Terminal 
sub-models and operational modes are distinguished by suffixes beginning with a -. Names should 
generally be based on original vendors, rather than local distributors. A terminal acquired from 
one vendor should not have more than one distinct basic name. 

Commands whose behavior depends on the type of terminal should accept arguments of the form 
-Tterm where term is one of the names given above; if no such argument is present, such com¬ 
mands should obtain the terminal type from the environment variable $TERM, which, in turn, 
should contain term. 
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SEE ALSO 

ex(l), man(l), mm(l), more(l), nroff(l), sh(l), stty(l), tabs(l), tset(l), ul(l), curses(3), ter- 
minfo(5), profile(5), ttytype(5), environ(7). 
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NAME 

types - primitive system data types 

SYNOPSIS 

^include <sys/types.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/RUN ONLY 

Origin: System III 

Remarks: The example given on this page is a typical version; the type names are in general 
expected to be present, although exceptions can be described in HARDWARE 
DEPENDENCIES. The fundamental type which implements each typedef is impleme- 
tation dependent, as long as source code which uses those typedefs need not be 
changed. 

DESCRIPTION 

The data types defined in the include file are used in HP-UX system code; some data of these 
types are accessible to user code: 

#define NREGS_S 13 /* no. of regs saved */ 

typedef struct { int r[l]; } * physadr; 

typedef long daddr_t; 

typedef char * caddr_t; 

typedef unsigned int uint; 

typedef unsigned short ushort; 

typedef ushort ino_t; 

typedef short cnt_t; 

typedef long time_t; 

typedef int label_t[NREGS_S]; 

typedef long dev_t; 

typedef long ofL_t; 

typedef long paddr_t; 

typedef long key_t; 

Note that the defined names above are standardized, but the actual type to which they are 
defined may vary between HP-UX implementations. 

The form daddr^t is used for disc addresses except in an i-node on disc, see /s(5). Times are 
encoded in seconds since 00:00:00 GMT, January 1, 1970. The major and minor parts of a device 
code specify kind and unit number of a device and are installation-dependent. Offsets are meas¬ 
ured in bytes from the beginning of a file. The labeL-t variables are used to save the processor 
state while another process is running. 

HARDWARE DEPENDENCIES 
Series 500: 

The types NREGS_S and label—t are not implemented. 

SEE ALSO 
fs(5). 
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NAME 

values - machine-dependent values 
SYNOPSIS 

^include <values.h> 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V Release 2 

DESCRIPTION 

This file contains a set of manifest constants, conditionally defined for particular processor archi¬ 
tectures. 

The model assumed for integers is binary representation (one’s or two^s complement), where the 
sign is represented by the value of the high-order bit. 


BlTS{type) 

The number of bits in a specified type (e.g., int). 

HIBITS 

The value of a short integer with only the high-order bit set (in most 
implementations, 0x8000). 

HIBITL 

The value of a long integer with only the high-order bit set (in most 
implementations, 0x80000000). 

HIBITI 

The value of a regular integer with only the high-order bit set (usually the 
same as HIBITS or HIBITL). 

MAXSHORT 

The maximum value of a signed short integer (in most implementations, 
OxTFFF = 32767). 

MAXLONG 

The maximum value of a signed long integer (in most implementations, 
0x7FFFFFFF = 2147483647). 

MAXINT 

The maximum value of a signed regular integer (usually the same as MAX- 
SHORT or MAXLONG). 


MAXFLOAT, LN_MAXFLOAT The maximum value of a single-precision fioating-point 

number, and its natural logarithm. 

MAXDOUBLE, LN_JVIAXDOUBLE The maximum value of a double-precision fioating-point 

number, and its natural logarithm. 

MINFLOAT, LN__MINFLOAT The minimum positive value of a single-precision fioating-point 

number, and its natural logarithm. 

MINDOUBLE, LN_MINDOUBLE The minimum positive value of a double-precision floating¬ 
point number, and its natural logarithm. 

FSIGNIF The number of significant bits in the mantissa of a single-precision 

floating-point number. 

DSIGNIF The number of significant bits in the mantissa of a double-precision 

floating-point number. 

FILES 

/ usr/include/values. h 

SEE ALSO 

intro(3), math(7). 
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NAME 

varargs - handle variable argument list 
SYNOPSIS 

^include <varargs.h> 

va_alist 

va_del 

void va_start(pvar) 

va_list pvar; 

type va_arg(pvar, type) 
va_list pvar; 

void va_end(pvar) 

va_list pvar; 

DESCRIPTION 

This set of macros allows portable procedures that accept variable argument lists to be written. 
Routines that have variable argument lists (such as prmtf{3S)) but do not use varargs are 
inherently nonportable, as different machines use different argument-passing conventions. 

va_alist is used as the parameter list in a function header. 

va_del is a declaration for vo—alist. No semicolon should follow vo—dcl. 

va_list is a type defined for the variable used to traverse the list. 
va_start is called to initialize pvar to the beginning of the list. 

va_arg will return the next argument in the list pointed to by pvar. Type is the type the argu¬ 

ment is expected to be. Different types can be mixed, but it is up to the routine to know what 
type of argument is expected, as it cannot be determined at runtime. 

va_end is used to clean up. 

Multiple traversals, each bracketed by vo—start... vo—end, are possible. 

EXAMPLE 

This example is a possible implementation of execl{2). 

^include <varargs.h> 

#define MAXARGS 100 

/ * execl is called by 

execl(file, argl, arg2, ..., (char *)0); 

*/ 

execl (va_alist) 
va_dcl 
{ 

va-Jist ap; 
char *file; 

char *args[MAXARGS]; 
int argno = 0; 

va_start(ap); 

file = va_arg(ap, char *); 

while ((args[argno++] = va_arg(ap, char *)) != (char *)0) 

va_end(ap); 
return execv(file, args); 
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} 

SEE ALSO 

exec(2), printf(3S). 

BUGS 

It is up to the calling routine to specify how many arguments there are, since it is not always pos¬ 
sible to determine this from the stack frame. For example, exed is passed a zero pointer to signal 
the end of the list. Print/ can tell how many arguments are there by the format. 

It is non-portable to specify a second argument of char, short, or float to vo—arg, since argu¬ 
ments seen by the called function are not char, short, or float. C converts char and short argu¬ 
ments to int and converts float arguments to double before passing them to a function. 
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NAME 

intro - introduction to system maintenance procedures 

DESCRIPTION 

This section outlines certain procedures that will be of interest to those charged with the task of 
system maintenance. Included are discussions on such topics as boot procedures, recovery from 
crashes, file backups, etc. 

SEE ALSO 

Section IM. No manual pages are included in Section 8 for this printing. Commands formerly in 
this section have been moved to Section IM. 
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NAME 

intro - introduction to glossary section 
DESCRIPTION 

This section contains a glossary of common HP-UX terms. References to other HP-UX docu¬ 
mentation are included as appropriate. References to entities such as wait{2), s/i(l), or fopen{3S) 
refer to entries in the HP-UX Reference manual. References to items in italics but having no 
parenthetical suffixes refer to other entries in the glossary. Finally, any references to italicized 
manuals refer to separate manuals that are included with your system. 
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.0 ("dot-oh") 
absolute path name 

access 

access groups 

address 


affiliation 
a.out 


archive 


ASCII 

asynchronous 10 
backup 

block 


A general name for an object file; also the format of an unlinked 
object file. See a.out. 

A path name beginning with a slash (/). It indicates that the 
file’s location is given relative to the root directory (/), and that 
the search begins there. 

Access to system resources is governed by three entities: the 
effective user ID, the effective group ID, and the group access 
list. 

The group access list is an additional set of group ID’s used only 
in determining resource accessibility. Access checks are per¬ 
formed as described below in file access permissions. 

In the context of peripheral devices, a set of values which specify 
the location of an I/O device to the computer. The exact details 
of the formation of an address differ between systems. On the 
Series 200 and 500, the address is composed of up to four ele¬ 
ments: the select code, bus address, unit number (id), and 
volume number (id). 

See terminal affiliation. 

a.out is the default output file name used by the linker, /d(l), 
and the C compiler, cc(l). It is also the format of executable 
object code files on HP-UX. The format is machine-dependent, 
and is described in the a.out{^) reference page for each imple¬ 
mentation. Object code which is as yet unlinked is in the same 
format, but is referred to as a .o ("dot-oh") file. 

A file which is made up of the contents of other files (such as a 
group of object (usually .o) files to be used by the linker, ld(l)). 
An archive file is created and maintained by ar(l), or by similar 
programs, such as tar{l) or cpio[l). (Note that tar{l) and 
cpio{l) files are not usually .o files.) An archive is often called a 
library. 

An acronym for American Standard Code for Information Inter¬ 
change. It consists of a set of characters including letters, 
numerals, punctuation, and control characters, each of which is 
represented internally by 7 bits (0 - 127). 

An 10 operation for which the user process need not wait for 
completion before continuing execution. 

The process of making a copy of all or part of the file system in 
order to preserve it should files be accidentally removed or des¬ 
troyed (due to a power failure, hardware error, user mishap, 
etc.). This is a highly recommended practice. 

(1) The fundamental unit of information HP-UX uses for access 
and storage allocation on a mass storage medium. The size of a 
block varies between implementations. On the Series 200 it 
varies from IK to 8K bytes; for the Series 500, see logical block 
size. 

(2) On media such as 9 track tape which write variable length 
strings of data, block is equivalent to the size of those strings. 
Block is often used to distinguish from record with a block con¬ 
taining several records, with the number of records being the 
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block special file 

boot or boot-up 
boot area 

boot ROM 

bus address 

CS/80 or CS-80 

character special file 

child process 

command 

command interpreter 


blocking factor. 

A special file associated with a mass storage device (such as a 
disc or a CS-80 tape cartridge drive) that transfers data by first 
putting it in the buffer cache and then passing it to the user pro¬ 
cess. If the user process requests data from a mass storage device 
that already has the data in the buffer cache, then no I/O to the 
mass storage device is necessary. Block special files may be 
mounted. 

The process of loading, initializing, and running an operating 
system. 

On the Series 200, a portion of a mass storage medium (block 
zero) on which the volume header and a small "bootstrap" pro¬ 
gram used in booting the operating system reside. The boot area 
is reserved exclusively for use by HP-UX. 

On the Series 500, the portion of an SDF mass storage medium 
which contains an operating system. 

A program residing in ROM (Read Only Memory) that executes 
each time the computer is powered-up. The function of the boot 
ROM is to run tests on the computer’s hardware, find all devices 
accessible through the computer, and then load either a specified 
operating system or the first operating system found according to 
a specific search algorithm. 

A number which makes up part of the address HP-UX uses to 
"find" a particular device. The bus address is determined by a 
switch setting on a peripheral device which allows the computer 
to distinguish between two devices connected to the same inter¬ 
face. A bus address is sometimes called a "device address". 

A family of mass storage devices that communicate via a com¬ 
mon protocol, CS/80 (Command Set ’80) command set. This 
family includes hard discs, removable discs, and tape devices. 

A special file associated with devices which transfer data by a 
means other than by using the buffer cache. Examples are 
printers, terminals, nine-track magnetic tapes, and discs accessed 
in "raw" mode (see raw disc). 

A new process created by an existing process via the fork{2) or 
vfork{2) system call. The new process is thereafter known to the 
existing process as its child process. The existing process is the 
parent process of the new process. See parent process and fork. 

A stand-alone unit of executable code (a program), or a file con¬ 
taining a list of other programs to execute in order (a shell 
script). In HP-UX, commands are executed through a command 
interpreter called a shell, often sh{l) or csh{l). Arguments fol¬ 
lowing the command name are passed on to the command pro¬ 
gram. You can write your own commands, either as executable 
programs, or as shell scripts (written in the shell programming 
language). 

A program which reads lines of text from standard input (typed 
at the keyboard or redirected from a file), and interprets them as 
requests to execute other programs. A command interpreter for 
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configuration 
control character 


crash 


current directory 
current working directory 
daemon 


data encryption 


default search path 


delta 


HP-UX is called a shell. See s/i(l) and c5/i(l). 

The ability to “customize” your kernel with the drivers, code, 
and tunable parameter values desired. 

A member of a character set which produces action in a device 
other than printing or displaying a character. In the ASCII 
character set, control characters are those in the range 0 through 
31, and 127. Control characters can be generated by holding 
down [CTRL], [CONTROL], or [CNTL] (depending on what the 
control key is labeled on your keyboard) and pressing a character 
key. These two-key sequences are often written as ctrl-d, for 
example, or "D, where " stands for the control key. Both 
representations assume that the control key is held down while 
the second key is pressed. 

The unexpected shutdown of a program or system. If the operat¬ 
ing system crashes, this is a "system crash", and requires the 
system to be re-booted. 

See working directory. 

See working directory. 

A process which runs in the background, and which is usually 
immune to termination instructions from a terminal. Its purpose 
is to perform various scheduling, clean-up, and maintenance jobs. 
Lpsched{l) is an example of a daemon that exists to perform 
these functions for line printer jobs queued by /p(l). An example 
of a permanent daemon (i.e. it never should die) is cron(Im). 

A method for encoding information in order to protect sensitive 
or proprietary data. For example, all users’ passwords are 
automatically encrypted by HP-UX. The encryption method 
used by HP-UX converts ASCII text into a base-64 representa¬ 
tion using the alphabet /, 0-9, A-Z, a-z. See passwd{^) for the 
numerical equivalents associated with this alphabet. 

The sequence of directory prefixes that s/i(l), time{l), and other 
HP-UX commands apply in searching for a file known by an 
incomplete path name (i.e. a path name not beginning with a 
slash, /). It is defined by the environment variable PATH (see 
environ(7)). Login{l) sets PATH equal to :/bin:/usr/bin, 
which means that your working directory is the first directory 
searched, followed by /bin, followed by /usr/bin. You can 
redefine the search path by modifying the value of PATH. This 
is usually done in /etc/profile, and/or in the .profile file found 
in your home directory (for the Bourne shell), or csh.login, 
.login, or cshrc (for the C-shell csh). 

A term used in the Source Code Control System (SCCS) to 
describe a unit of one or more textual changes to an SCCS file. 
Each time you edit an SCCS file, the changes you make to the 
file are stored separately as a delta. Then, using the get{l) com¬ 
mand, you can specify which deltas are to be applied to or 
excluded from the SCCS file, thus yielding a particular version of 
the file. (Contrast this with the vi or ed editor, which incor¬ 
porates your changes into the file immediately, prohibiting you 
from obtaining a previous version of that file.) See SCCS, SCCS 
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demon 
device file 
directory 


effective group ID 


effective user ID 


file. 

See daemon. 

See special file. 

A file which provides the mapping between the names of files and 
their contents. For every file name contained in a directory, that 
directory contains a pointer to the file’s i-node called a link . A 
file may have several links appearing anywhere on the same file 
system. Each user is free to create (using mkdir{l)) as many 
directories as he needs, providing that the parent directory of the 
new directory gives him permission to do so. Once a directory 
has been created, it is ready to contain ordinary files and other 
directories. An HP-UX directory is named and behaves exactly 
like an ordinary file, with one exception: no user (including the 
super-user) is allowed to write data on the directory itself; this 
privilege is reserved for the HP-UX operating system. 

By convention, a directory contains at least two links, . and 
referred to as dot and dot-dot respectively. Dot refers to the 
directory itself and dot-dot refers to its parent directory. For 
purposes of deletion, a directory containing only . and .. is con¬ 
sidered empty. (In the root directory, and are 

identical.) 

Every process has an effective group ID that is used to determine 
file access permissions. A process’s effective group ID is deter¬ 
mined by the file (conunand) that process is executing. If that 
file’s set-group-ID bit is set (located in the mode of the file - see 
mode), then the process’s effective group ID is set equal to the 
file’s group ID. This makes the process appear to belong to the 
file’s group, perhaps enabling the process to access files which 
must be accessed in order for the program to execute successfully. 
If the file’s set-group-ID bit is not set, then the process’s 
effective group ID can only be set by an explicit call to getuid{2) 
or setuid{2). The id is always inherited from parent across a 
fork{2). The setuid/getuid bit determines whether it is inhereted 
across exec{2). See group, real group ID, and set-group-ID bit. 

A process has an effective user ID that is used to determine file 
access permissions (and other permissions with respect to system 
calls, if the effective user ID is 0 - that of the super-user). A 
process’s effective user ID is determined by the file (command) 
that process is executing. If that file’s set-user-ID bit is set 
(located in the mode of the file - see mode), then the process’s 
effective user ID is set equal to the file’s user ID. This makes the 
process appear to be the file’s owner, enabling the process to 
access files which must be accessed in order for the program to 
execute successfully. (Many HP-UX commands which are owned 
by root, such as mail{l), have their set-user-ID bit set so other 
users can execute these commands.) If the file’s set-group-ID bit 
is not set, then the process’s effective group ID can only be set 
by an explicit call to getuid{2) or setuid[2). The id is always 
inherited from parent across a fork{2). The setuid/getuid bit 
determines whether it is inhereted across exec (2). See real user 
ID and set-user-ID bit. 
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environment 


end-of-file 


file 


file access permissions 


The set of defined shell variables (some of which are PATH, 
TERM, SHELL, EXINIT, HOME, etc.) which define the condi¬ 
tions under which your commands run. These conditions can 
include your terminal characteristics, your home directory, and 
your default search path. Each shell variable setting in the 
current process is passed on to all child processes that are 
created, provided that each shell variable setting has been 
exported via the export command (see sh{l)) or setenv{l) with 
csh{l). Unexported shell variable settings are meaningful only to 
the current process, and any child processes created are given the 
default settings given certain shell variables in /etc/profile 
and/or %HOME/.profile (when using the Bourne shell) or 
/etc/csh.login^ .login^ or cshrc (when using the C-shell). 

(1) the data returned when attempting to read past the logical 
end of a file via stdio{SS) routines. In this case end-of-file is not 
properly a character. (2) The character [CTRL]-[D]. (3) A 
character defined by stty{l) or ioctl(2) (see termio{^)). to act as 
end-of-file on your terminal. Usually this is [CTRL]-[D]. (4) 
The indication (as the function result) which indicates end of 
data when using read{2). 

An HP-UX file is simply a group of logically related bytes of 
information. These bytes, for example, could be a bytes of exe¬ 
cutable code or bytes of data. Thus, directories, ordinary files, 
special files, etc. can all be considered files. Every file must have 
a file name (see file name) which enables the user (and many of 
the HP-UX commands) to reference the contents of the file. The 
size of a file is exactly the number of bytes the file contains - the 
system imposes no particular structure on the contents of a file 
(although some programs do). Files may be accessed serially or 
randomly (indexed by byte offset). The interpretation of file 
contents and structure is up to the programs that access the file. 

Every file in the file system has a set of access per- missions. 
These permissions are used in determining whether a process may 
perform a requested operation on the file (such as opening a file 
for writing). Access permissions are established at the time a file 
is created. They may be changed at some later time through the 
chmod(2) call. 

File access is broken down according to whether a file may be: 
read, written, or executed. Directory files use the execute per¬ 
mission to control if the directory may be searched. 

File access permissions are interpreted by the system as they 
apply to three different classes of users: the owner of the file, 
those users in the file’s group, anyone else. Every file has an 
independent set of access permissions for each of these classes. 
When an access check is made, the system decides if permission 
should be granted by checking the access information applicable 
to the caller. 

Read, write, and execute/search permissions on a file are granted 
to a process if: 

The process’s effective user ID is super-user. 
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file descriptor 


file name 


file pointer 


The process’s effective user ID matches the user ID of the 
owner of the file and the appropriate access bit of the 
“owner” portion (0700) of the file mode is set. 

The process’s effective user ID does not match the user 
ID of the owner of the file, and either the process’s 
effective group ID matches the group ID of the file, or the 
group ID of the file is in the process’s group access list, 
and the appropriate access bit of the “group” portion 
(070) of the file mode is set. 

The process’s effective user ID does not match the user 
ID of the owner of the file, and the process’s effective 
group ID does not match the group ID of the file, and the 
appropriate access bit of the “other” portion (07) of the 
file mode is set. 

Otherwise, the corresponding permissions are denied. 

A small integer identifier, which is used to refer to a file that has 
been opened for reading and/or writing, and is an index into the 
user’s table of open files. The opened file must be identified by 
its file descriptor when using system calls to read or write the 
file. 

The value of a file descriptor has a range from 0 to a system 
defined maximum. For systems at HP-UX STANDARD and 
above, the minimum value for this number is 60. For systems 
below HP-UX STANDARD the minimum value is 20. No file 
descriptor may have a value outside the range 0-59 or 0-19, 
depending on the implementation. 

A file descriptor is obtained through system calls such as 
open(2), crea<(2), dup{2), fcntl{2) or pipe{2). The file descriptor 
is used as an argument by calls such as read{2), write{2), ioctl{2), 
and close{2). 

A string of up to 14 characters which is used to refer to the con¬ 
tents of an ordinary file, special file, or directory. These charac¬ 
ters may be any ASCII character except ASCII values 0 (null) 
and 47 (slash - /). Note that it is generally unwise to use *, ?, [, 
!, or ] as part of file names because of the special meaning the 
shell attaches to these characters (see sh{l)). It is also not wise 
to begin a file name with -, +, or =, because some programs 
assume that these characters indicate that a command argument 
follows. Although permitted, it is advisable to avoid the use of 
characters which do not have a printable graphic on the 
hardware you commonly use, or which are likely to confuse the 
hardware. 

A data element, obtained through any of the fopen{3S) standard 
I/O library routines, which "points to" (refers to) a file opened 
for reading and/or writing, and which keeps track of where the 
next I/O operation will take place in the file (in the form of a 
byte offset relative to the beginning of the file). After obtaining 
the file pointer, it must thereafter be used to refer to the open file 
when using any of the standard I/O library routines. (See 
stdio(3S) for a list of these routines.) 
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file system 

filter 

fork 


group 


group access list 

hierarchical directory 
home directory 


host name 


The supporting data structures, HP-UX directory structure, and 
associated files that reside on one or more mass storage volumes. 
Refer to the System Administrator Manual supplied with your 
system for details concerning file system implementation and 
maintenance. 

A command which reads data from the standard input, performs 
a transformation on the data, and writes it to the standard out¬ 
put. 

An HP-UX system call {fork{2)) which, when invoked by an 
existing process, causes a new process to be created. The new 
process is called the child process; the existing process is called 
the parent process. The child process is created by making an 
exact copy of the parent process. The parent and child processes 
are able to identify themselves by the value returned by their 
corresponding fork call (see fork{2) for details). 

A group is a set of 0 or more users who are usually logically 
related in some way (e.g., all users who are working on a particu¬ 
lar project) and who generally require the sharing of data 
between each other. The members of a group are defined in the 
file /etc/passwd via a numerical group ID (users with identical 
group IDs are members of the same group). An ASCII group 
name is associated with each group ID in the file /etc/group (the 
members of each group can be listed in /etc/group, also, but this 
information is purely for user benefit, and is of little use to the 
system). A group ID is associated with every file in the file sys¬ 
tem, and the mode of each file contains a set of permission bits 
which apply only to groups of which the file owner is a member. 
Thus, if you are a member of the group associated with the file, 
and if the appropriate permissions are given to your group in the 
file’s mode, you may access the file. See real group ID, effective 
group ID, accessgroups, privilegedgroup, and set-group-ID bit 

The group access list is an additional set of group ID’s used only 
in determining resource accessibility. Access checks are per¬ 
formed as described in file access permissions. 

A directory (or file system) structure in which each directory 
may contain other directories as well as files. 

The directory name given by the value of the shell variable 
HOME. When you first log in, login{l) automatically sets 
HOME equal to your login directory (see login directory). You 
may change its value at any time, however. This is usually done 
in the .profile file contained in your login directory. Setting 
HOME in no way affects your login directory, but simply gives 
you a convenient way of referring to what should be your most 
commonly-used directory. 

An ASCII string of at most 8 characters (of which only 6 are 
supported by all the various manufactuer’s UNIX systems) which 
uniquely identifies an HP-UX system on a uucp network. The 
host name for your system may be viewed and/or set with the 
hostname(l) command. Systems without a defined host name 
are described as "unknown" on the uucp network. Do not con¬ 
fuse a host name with a node name, which is a string that 
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uniquely identifies an HP-UX system on a Local Area Network 
(LAN). Although your host and node names may be identical 
(and this is often advisable), they are set and used by totally 
different software. See node name. 

i-node Each ordinary or special file, or directory has associated with it 

an i-node. The i-node contains, among other things, the file’s 
size, protection mask, the number of links, and pointers to the 
disc blocks where the file’s contents can be found. Each connec¬ 
tion between an i-node and its entry in one or more directories is 
called a link. 

The current state of your computer (or your portion of the com¬ 
puter, on a multi-user system) during the execution of a com¬ 
mand. Often thought of as a "snapshot" of the state of the 
machine at any particular monient during execution. 

A special process (the initialization process) usually with a pro¬ 
cess ID of 1. It is the ancestor of every other process in the sys¬ 
tem and is used to start login processes. 

interleave factor A number which determines the order in which sectors on a mass 

storage medium are accessed. It can be optimized to make data 
acquisition more efficient. 

Internal Terminal Emulator {ITE) 

The "device driver" code contained in the HP-UX kernel and 
associated with the computer’s built-in keyboard and display or 
a particular keyboard and display connected to the computer, 
depending on the Series and Model of your HP-UX computer. 
See system console and the System Adminstrator Manual sup¬ 
plied with your system for details. 

interrupt signal The signal sent by SIGINT (see signal{2)). This signal generally 

terminates whatever program you are running. The key which 
sends this signal can be redefined with ioctl{2) or stty{l) (see ter- 
mio{A)). It defaults to the ASCII DEL (rubout) character (the 
[DEL] key) or the [BREAK] key. [CONTROL]-[C] is often used 
instead. 

See system call. 

A mechanism provided by the HP-UX shell for changing the 
source of data for standard input and/or the destination of data 
for standard output and standard error. See sh(l). 

The HP-UX operating system. The kernel is the executable code 
responsible for managing the computer’s resources, such as allo¬ 
cating memory, creating processes, and scheduling programs for 
execution. 

library An archive file containing a set of subroutines and variables 

which may be accessed by user programs. For example, 
/lib/libc.a is a library containing all functions of section 2, and all 
functions of section 3 marked (3C) and (3S), in the HP-UX 
Reference. Similarly, /lib/libm.a is a library containing all func¬ 
tions in section 3 marked (3M) in the HP-UX Reference. See 
intro{3). 
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LIF An acronym for Logical Interchange Format. A standard format 

for mass storage implemented on many Hewlett-Packard com¬ 
puters to aid in media transportability. The commands 

are used to perform various functions using LIF. 

link A directory entry for any type of file. The information constitut¬ 

ing a link includes the name of the file, and where the contents of 
that file may be found on a mass storage medium. One physical 
file may have several links to it. If the links appear in different 
directories, the file may or may not have the same name in each. 
If the links appear in one directory, however, each link must have 
a unique name in that directory. Multiple links to directories are 
not allowed (except for the super-user). See cp(l), link{l), 
link{2), and unlink{2). Also, to prepare a program for execution, 
see linker. 

linker The linker combines one or more object programs into one pro¬ 

gram, searches libraries to resolve user program references, and 
builds an executable file in a. out format. This executable file is 
ready to be executed through the program loader, exec(2). The 
linker is invoked with the ld{l) command. The linker is often 
called a link editor. 

The smallest unit of memory which can be allocated on a Series 
500 SDF volume; a multiple of the physical sector size. This 
value is set at system initialization time; see sdfinit{lM). 

The process of gaining access to HP-UX. This consists of suc¬ 
cessful execution of the login sequence defined by login{l) which 
varies depending on the system configuration. It includes pro¬ 
viding a login name and possibly one or more passwords. 

The directory in which you are placed immediately after you log 
in. This directory is defined for each user in the file /etc/passwd. 
The shell variable HOME is set automatically to your login 
directory by login{l) immediately after you log in. See home 
directory. 

The first word of an a.out{b) or archive file. This word contains 
the system ID, which tells what machine (hardware) the file will 
run on, and the file type (executable, shareable executable, 
archive, etc.). 

A number used exclusively to create special files that enable I/O 
to/from specific devices. This number indicates which device 
driver to use for the device. Refer to mknod(\M) and the System 
Administrator Manual supplied with your system for details. 

message queue identifier A message queue identifier (msqid) is a unique positive integer 

created by a msgget{2) system call. Each msqid has a message 
queue and a data structure associated with it. The data struc¬ 
ture is referred to as msqid—ds and contains the following 
members: 

ipc_perm msg_perm; /* operation permission struct */ 
msg_qnum; /* number of msgs on q */ 

msg_qbytes; /* max number of bytes on q +/ 

msg_lspid; /* pid of last msgsnd operation */ 

msg__lrpid; /* pid of last msgrcv operation ♦/ 


struct 

ushort 

ushort 

ushort 

ushort 


magic number 


major number 


logical block size 


login 


login directory 
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/+ last msgsnd time */ 

/ * last msgrcv time */ 

/♦ last change time */ 

/♦ Times measured in secs since */ 

/* 00:00:00 GMT, Jan. 1, 1970 */ 

Msg—perm is a ipc_perm structure that specifies the message 
operation permission (see below). This structure includes the 




following members: 

ushort 

cuid; 

/* creator user id */ 

ushort 

cgid; 

/* creator group id ♦/ 

ushort 

uid; 

/* user id ♦/ 

ushort 

gid; 

/* group id */ 

ushort 

mode; 

/* r/w permission */ 


Msg_qnum is the number of messages currently on the queue. 
Msg_qbytes is the maximum number of bytes allowed on the 
queue. Msg_lspid is the process id of the last process that per¬ 
formed a msgsnd operation. Msg_lrpid is the process id of the 
last process that performed a msgrcv operation. Msg_stime is 
the time of the last msgsnd operation, msg__rtime is the time of 
the last msgrcv operation, and msg_ctime is the time of the 
last msgctl{2) operation that changed a member of the above 
structure. 

message operation permissions In the msgop{2) and msgctl{2) system call descriptions, the per¬ 
mission required for an operation is given as "{token}", where 
"token" is the type of permission needed interpreted as follows: 

00400 Read by user 

00200 Write by user 

00060 Read, Write by group 

00006 Read, Write by others 

Read and Write permissions on a msqid are granted to a process 
if one or more of the following are true: 

The process’s effective user ID is super-user. 

The process’s effective user ID matches msg_perm.[c]uid 
in the data structure associated with msqid and the 
appropriate bit of the “user” portion (0600) of 
msg_perm.mode is set. 

The process’s effective user ID does not match 

msg_perm.[c]uid and the process’s effective group ID 
matches msg_perm.[c]gid and the appropriate bit of the 
“group” portion (060) of msg_perm.mode is set. 

The process’s effective user ID does not match 

msg_perm.[c]uid and the process’s effective group ID 
does not match msg_perm.[c]gid and the appropriate bit 
of the “other” portion (06) of msg_perm.mode is set. 

Otherwise, the corresponding permissions are denied. 

metacharacter A character which has special meaning to the HP-UX shell. The 

set of metacharacters includes: *, ?, !, [, ], <,>,;, |, ", and 

&. Refer to sh(l) for the meaning associated with each. 


time_t msg_stime; 

time_t msg_rtime; 

time_t msg_ctime; 
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minor number 


mode 


mountable file system 


multi-user state 


new-line 


node name 


A number used exclusively to create special files that enable I/O 
to/from specific devices. This number is passed to the device 
driver and is used to select which device in a family of devices is 
to be used, and possibly some operational modes. The exact for¬ 
mat and meaning of the minor number is both system and driver 
dependent. Refer to the System Administrator Manual supplied 
with your system for details. See address. 

On the Series 200 and 500, for HP-IB devices, this mmiber indi¬ 
cates the HP-IB address, select code, and the unit and/or volume 
numbers. 

A 16-bit word associated with every file in the file system, stored 
in the i-node. The least-significant 12 bits of this word deter¬ 
mine the read, write, and execute permissions for the file owner, 
file group, and all others, and contain the set-user-ID, set- 
group-ID, and "sticky" (save text image after execution) bits. 
The least-significant 12 bits are settable by the chmod{l) com¬ 
mand if you are the file’s owner or the super-user. The sticky bit 
can only be set by the super-user. These 12 bits are sometimes 
referred to as permission bits. The most-significant 4 bits specify 
the file type for the associated file and are set as the result of 
creat{2), open(2), or mknod{2) system calls. 

A (blocked special) file system contained on some mass storage 
medium with its own root directory and an independent hierar¬ 
chy of directories and files. See block special file and mount{l). 

The condition of the HP-UX operating system in which termi¬ 
nals in addition to the system console are allowing communica¬ 
tion between the system and its users. By default, the Series 200 
multi-user state is state 2, and the Series 500 multi-user state is 
state 1. Do not confuse the multi-user system with the multi¬ 
user state. A multi-user system is a system which may have 
more than one user actively communicating with the system 
when it is in the multi-user state. Multi-user states—there can 
be more than one multi-user state in inittab — remove the 
single-user restriction imposed by the single-user state. See 
single-user state. See inittab[h). 

The character with an ASCII value of 10 (line-feed) used to 
separate lines of characters. It is represented by \n in the C 
language and in various utilities. The terminal driver (see tty[A)) 
normally interprets the carriage-return/line-feed sequence sent 
by a terminal as a single new-line character. 

A string of up to 31 characters, not including control characters 
or spaces, that uniquely identifies a node on a Local Area Net¬ 
work (LAN). The node name for each system is set by the 
npowerup command, which is one of the commands supplied with 
the optional LAN/9000 product. Do not confuse a node name 
with a host name, which is a string that uniquely identifies an 
HP-UX system on a uucp network. Your node and host names 
can be identical, but they are used and set by totally different 
software. See host name, LAN/9000 User’s Guide, and 
LAN/9000 Node Manager’s Guide. 
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ordinary file 


orphan process 


OSF 


owner 


parent directory 


parent process 


password 


path name 


A type of HP-UX file containing ASCII text (e.g. program 
source), binary data (e.g. executable code), etc. Ordinary files 
can be created by the user through I/O redirection, editors, or 
HP-UX commands. 

Whenever a parent process terminates for any reason and leaves 
behind one or more child processes that are still active, those 
child processes are called orphan processes. Init{lM) inherits 
(becomes the effective parent of) all orphan processes. 

An acronym for Operating System File. An OSF resides in the 
SDF boot area on a Series 500 system, and contains all or part of 
an operating system. See osmgr^lM), oscp(lM), osc/c(lM), and 
osmark{lM). 

The owner of a file is usually the creator of that file. However, 
the ownership of a file can be changed by the super-user or the 
current owner with the chown[l) commaiKi or the chown{2) sys¬ 
tem call. The file owner is able to do whatever he wants with his 
files, including remove them, copy them, move them, change 
their contents, etc. He is also able to change the files’ modes. 

A directory’s parent directory is the directory one level above it 
in the file hierarchy. All directories except the root directory (/) 
have one (and only one) parent directory. The parent directory 
is sometimes referred to as the superior directory. 

Whenever a new process is created by a currently-existing pro¬ 
cess (via fork{2) or vfork{2))^ the currently-existing process is 
said to be the parent process of the newly-created process. 
Every process has exactly one parent process (except the init 
process - see init), but each process can create several new 
processes with the fork{2) system call. The parent process ID of 
any process is the process ID of its creator. 

A string of ASCII characters used to verify the identity of a user. 
Passwords can be associated with users and groups. If a user has 
a password, it is automatically encrypted and entered in the 
second field of that user’s line in the /etc/passwd file. A user 
may create or change a password for himself with the passwd{l) 
command. 

(sometimes written as one word, pathname). A sequence of 
directory names separated by slashes, and ending with any file 
name. All file names except the last in the sequence must be 
directories. If a path name begins with a slash (/), it is an abso¬ 
lute path name (see absolute path name); otherwise it is a relative 
path name (see relative path name). A path name defines the 
path to be followed through the hierarchical file system in order 
to find a particular file. 

More precisely, a path name is a null-terminated character string 
constructed as follows: 


<path-name>::=<file-name>l<path-prefix><file-name> I / 
<path-prefix>::=< rtprefix> | / < rtprefix> 

<rtprefix>::=< dirname> /1 <rtprefix> < dirname > / 
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permission bits 


pipe 


privileged groups 


procl 

process 


process group 


process group ID 


process group leader 


where <file-name> is a string of 1 to 14 characters other than 
the ASCII slash and null, and <dirnanie> is a string of 1 to 14 
characters (other than the ASCII slash and null) that names a 
directory or network special file with RFA (Remote File Access). 

A slash by itself names the root directory. 

Unless specifically stated otherwise, the null path name is treated 
as if it named a non-existent file. 

The nine least-significant bits of a file’s mode. These bits deter¬ 
mine read, write, and execute permissions for the file’s owner, the 
file’s group, and all others. See chmod{2) for further details. 

An inter-process I/O channel used to pass data between two 
processes. It is commonly used by the shell to transfer data from 
the standard output of one process to the standard input of 
another. On a command line, a pipe is signaled by a vertical bar 
(I). The output from the command(s) on the left of the vertical 
bar is channeled directly into the standard input of the 
command(s) on the right. The pipe(2) intrinsic function allows 
user programs to take advantage of this feature. 

A privileged group is a group which has had a setprivgrp (see 
getprivgrp{2)) operation performed on it giving it access to some 
system calls otherwise reserved for the super-user. 

See init. 

An invocation of a program, or the execution of an image. No 
command can be executed without a process in which it can exe¬ 
cute. Alternately, a process cannot exist without a command or 
image in some stage of execution. Several processes can all be 
running the same program, but each may have different data and 
be in different stages of execution. 

An association of one or more processes is called a process group. 
A process’s membership in a particular process group is esta¬ 
blished by a numerical process group ID. Each process can 
belong to only one process group. Every process group has a 
process group leader. See process group ID and process group 
leader. 

A positive integer in the range 1 - 30000 associated with every 
active process, which establishes that process’s membership with 
a particular process group. All members of a process group have 
the same process group ID. A process group ID is always the 
process ID of the process group leader. This grouping permits 
the signalling of related processes. See kill{2), process group, and 
process group leader. 

A process group leader is a process whose process group ID and 
process ID are equal. A process becomes a process group leader 
through the setpgrp{2) system call. All processes created by the 
process group leader become members of that process group. All 
processes created by the init process (see init) are process group 
leaders. For example, when you log in on the system, the shell 
you receive to interpret your commands is a process group leader, 
and all subsequent process’s created by your shell are members of 
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quit signal 
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your shell’s process group. See process group ID and process 
group. 

Each active process in the system is uniquely identified by a 
positive integer called a process ID. The range of this ID is from 
1 to 30000. This permits the selective sending of signals to 
processes with kill{2), or signal(2). The process ID of any 

user process is available with the ps(l) command. If a back¬ 
ground process is created, the shell reports its process ID to you 
when execution has begun. 

A sequence of instructions, either binary (as machine object code) 
or text (as source code or shell scripts), that define an algorithm 
that can be carried out by a computer. C, FORTRAN, Pascal, 
and BASIC source; awk source; shell scripts; and executable 
object {a.out(5)) are all examples of programs. 

The character(s) displayed by the shell on the display indicating 
that the system is ready for a command. The prompt is usually 
a dollar sign ($) for ordinary users and a pound sign (#) for the 
super-user, but the user can re-define it to be any string by set¬ 
ting the shell variable PSl in his .profile file. 

The signal sent by SIGQUIT. See signal(2). The quit signal is 
generated by typing the character defined by the teletype handler 
as your quit signal. (See stty{l), ioctl{2), and termio{4:).) The 
default is the ASCII FS character (ASCII value 28, generated by 
typing [CONTROL]-[\].) This signal usually causes a running 
program to terminate and generates a file containing the "core 
image" of the terminated process. The core image is useful for 
debugging purposes. (Some systems do not support core images, 
and on those systems no such file is generated.) 

The name given to a disc for which there exists a character spe¬ 
cial file which allows direct transmission between the disc and the 
user’s read or write buffer. 

A positive integer which is assigned to every user on the system. 
The association of a user and his real group ID is done in the file 
/etc/passwd. The modifier "real" is used because a user can also 
have an effective group ID (see effective group ID). The real 
group ID can then be mapped to a group name in the file 
/etc/group, although it need not be. Thus, every user is a 
member of some group (which may be nameless), even if that 
group has only one member. 

Every time a process creates a child process (via fork{2)), that 

process has a real group ID equal to the parent process’s real 

group ID. 

A positive integer which is assigned to every user on the system. 
A real user ID is assigned to every valid login name in the file 
/etc/passwd. The modifier "real" is used because a user can also 
have an effective user ID (see effective user ID). 

Every time a process creates a child process (via fork{2)), that 

process has a real user ID equal to the parent process’s real user 

ID. 
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regular expression 


relative path name 


root directory 


root volume 


saved user ID 


saved group ID 


sees 


A string of zero or more characters; the characters contained in 
the string may all be literal, which means that the regular 
expression matches itself only, or one or more of the characters 
may be a metacharacter, which means that a single regular 
expression could match several literal strings. Regular expres¬ 
sions are most often encountered in text editors (ed(l), ex{l), 
V 2 (l)), where searches are performed for a specific piece of text, 
or in commands that were created to search for a particular 
string in a file (most notably grep{l)). Sh{l) and c5/i(l) also use 
metacharacters to match one or more patterns; this is a different 
mechanism that regular expressions. See ed{l). 

A path name that does not begin with a slash. It indicates that 
a file’s location is given relative to your current working direc¬ 
tory, and that the search begins there (instead of at the root 
directory). An example is dirl/file2, which searches for the 
directory dirl in your current working directory. Dirl is then 
searched for the file file2. 

1) The highest level directory of the hierarchical file system, from 
which all other files branch. In HP-UX, the "/" character refers 
to the root directory. The root directory is the only directory in 
the file system which is its own parent directory. 

2) Each process has associated with it a concept of a root direc¬ 
tory for the purpose of resolving path name searches for those 
paths beginning with A process’s root directory need not be 
the root directory of the root file system, and can be changed by 
the chroot{l) command or chroot{2) system call. Such a direc¬ 
tory appears to the process involved to have .. pointing to itself. 

The mass storage volume which contains the boot area (which 
contains the HP-UX kernel) and the root directory of the HP- 
UX file system. 

Every process has a saved user ID which retains the process’s 
effective user ID from the last successful exec(2), or from the last 
super-user call to setuid{2). Setuid{2) permits a process to set its 
effective user ID to this remembered value. Consequently, a pro¬ 
cess which executes a program with the set-user-ID bit set and 
with an owner ID of 5 (for example) can set its effective user ID 
to 5, or to its real user ID, any time until the program ter¬ 
minates. See ea:ec(2), setuid{2), saved group ID^ effective user 
ID, and set-user-ID hit 

Every process has a saved group ID which retains the process’s 
effective group ID from the last successful exec(2), or from the 
last super-user call to setgid. Setgid permits a process to set its 
effective group ID to this remembered value. Consequently, a 
process which executes a program with the set-group-ID bit set 
and with a group ID of 5 (for example) can set its effective group 
ID to 5, or to its real group ID, any time until the program ter¬ 
minates. See exec{2), setuid(2), saved user ID, effective group 
ID, and set-group-ID hit. 

An acronym for Source Code Control System. The Source Code 
Control System is a set of HP-UX commands which enable you 
to store changes to an SCCS file as separate "units" (called 
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sees file 


SDF 


secondary prompt 


select code 


semaphore identifier 


deltas). These units, each of which contains one or more textual 
changes to the file, can then be applied to or excluded from the 
sees file to obtain different versions of the file. The commands 
that make up SeeS are admm{l), cdc(l), delta(l)^ /?rs(l), 

rmde/(l), sflc^(l), sccsdiff{l), unget{l), val{l), and what{l). See 
delta, sees file. 

An ordinary text file which has been modified so that the Source 
eode eontrol System (SeeS) may be used with it. This 
modification is done automatically by the admin{l) command. 
See sees, delta. 

An acronym for Structured Directory Format. SDF is imple¬ 
mented on the Series 500 computers only, and provides tree- 
structured access to files through the root directory of the 
volume. 

One or more characters that the Bourne shell sh{l) prints on the 
display, indicating that more input is needed. This prompt is 
much less often encountered than the shell’s primary prompt (see 
prompt). When it occurs, it is usually caused by an omitted 
right quote on a string (which confuses the shell), or when you 
enter a shell programming language control-flow construct (such 
as a for construct) from the command line. By default, the 
shell’s secondary prompt is the greater-than sign (>), but you 
can re-define it by setting the shell variable PS2 appropriately 
in your .profile file. 

On the series 200 and 500 part of an address used for devices. A 
number determined by a setting on the interface card to which a 
peripheral device is connected, or by the particular I/O slot the 
I/O card resides in. Multiple peripherals connected to the same 
interface card share the same select code. 

A semaphore identifier (semid) is a unique positive integer 
created by a semget(2) system call. Each semid has a set of 
semaphores and a data structure associated with it. The data 
structure is referred to as semid—ds and contains the following 
members: 

struct ipc_perm sem_perm; /* operation permission struct */ 

ushort sem_nsems; /* number of sems in set */ 

time_t sem_otime; /* last operation time */ 

time_t sem_ctime; /* last change time */ 

/* Times measured in secs since */ 

/* 00:00:00 GMT, Jan. 1, 1970 */ 

Sem_perm is a ipc_perm structure that specifies the sema¬ 

phore operation permission (see below). This structure includes 
the following members: 


ushort 

cuid; 

/* creator user id */ 

ushort 

cgid; 

/+ creator group id */ 

ushort 

uid; 

/♦ user id */ 

ushort 

gid; 

/* group id */ 

ushort 

mode; 

/* r/a permission */ 


The value of sem_nsems is equal to the number of semaphores 
in the set. Each semaphore in the set is referenced by a positive 
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integer referred to as a serri—num. Sem_num values run 

sequentially from 0 to the value of sem_nsems minus 1. 

Sem otime is the time of the last semop{2) operation, and 

sem ctime is the time of the last semctl{2) operation that 

changed a member of the above structure. 


A semaphore is a data structure that contains the following 
members: 


ushort semval; 
short sempid; 
ushort senmcnt; 
ushort semzcnt; 


/♦ semaphore value */ 

/* pid of last operation ♦/ 

/* # awaiting semval > cval */ 
/* # awaiting semval = 0 ♦/ 


Semval is a non-negative integer. Sempid is equal to the pro¬ 
cess ID of the last process that performed a semaphore operation 
on this semaphore. Semncnt is a count of the number of 
processes that are currently suspended awaiting this semaphore’s 
semval to become greater than its current value. Semzcnt is a 
count of the number of processes that are currently suspended 
awaiting this semaphore’s semval to become zero. 


semaphore operation permissions 

In the semop{2) and semctl{2) system call descriptions, the per¬ 
mission required for an operation is given as "{token}", where 
"token" is the type of permission needed interpreted as follows: 


00400 Read by user 

00200 Alter by user 

00060 Read, Alter by group 

00006 Read, Alter by others 


Read and Alter permissions on a semid are granted to a process 
if one or more of the following are true: 


The process’s effective user ID is super-user. 

The process’s effective user ID matches sem_perm.[c]uid 
in the data structure associated with semid and the 
appropriate bit of the “user” portion (0600) of 
sem_^perm.mode is set. 

The process’s effective user ID does not match 

sem_perm.[c]uid, and either the process’s effective group 

ID matches sem_perm.[c]gid or sem_perm.[c]gid is in 
the process’s group access list, and the appropriate bit of 
the “group” portion (060) of sem_perm.mode is set. 

The process’s effective user ID does not match 

sem_perm.[c]uid, and the process’s effective group ID 

does not match sem_perm.[c]gid and neither is 

sem_^perm.[c]gid in the process’s group access list, and 

the appropriate bit of the “other” portion (06) of 
sem_perm.mode is set. 


Otherwise, the corresponding permissions are denied. 

set-group-ID bit A single bit in the mode of every file in the file system. If a file is 

executed whose set-group-ID bit is set, then the effective group 
ID of the process which executed the file is set equal to the real 
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group ID of the owner of the file. See effective group ID, group, 
and real group ID. 

set-user-ID bit A single bit in the mode of every file in the file system. If a file is 

executed whose set-user-ID bit is set, then the effective user ID 
of the process which executed the file is set equal to the real user 
ID of the owner of the file. See effective user ID and real user 
ID. 


shared memory identifier A shared memory identifier (shmid) is a unique positive integer 

created by a shmget{2) system call. Each shmid has a segment 
of memory (referred to as a shared memory segment) and a data 
structure associated with it. The data structure is referred to as 
shmid—ds; some of its members are: 


struct 

int 

ushort 

ushort 

short 

time_t 

time_t 
time_t 


ipc_perm shm_perm; /* operation permission struct */ 

shm_segsz; /* size of segment */ 

shm_cpid; /* creator pid */ 

shm_Ipid; /* pid of last operation */ 

shm_nattch; /+ number of current attaches */ 

shm_atime; /* last attach time */ 

shm_dtime; /* last detach time */ 

shm_ctime; /* last change time */ 

/* Times measured in secs since ♦/ 

/* 00:00:00 GMT, Jan. 1, 1970 */ 
Shm_perm is a ipc_perm structure that specifies the shared 
memory operation permission (see below). This structure 
includes the following members: 


ushort 

cuid; 

/ * creator user id */ 

ushort 

cgid; 

/* creator group id */ 

ushort 

uid; 

/* user id */ 

ushort 

gid; 

/*■ group id */ 

ushort 

mode; 

/♦ r/w permission ♦/ 


Shm_segsz specifies the size (in bytes) of the shared memory 

segment. Shm_cpid is the process id of the process that 
created the shared memory identifier. Shm_Jpid is the process 
id of the last process that performed a shmop{2) operation. 

Shm_nattch is the number of times the segments are currently 

attaching to other processes. Shm_atime is the time of the last 

shmat operation, shm_dtime is the time of the last shmdt 
operation, and shm_ctime is the time of the last shmctl{2) 
operation that changed one of the members of the above struc¬ 
ture. 


shared memory operation permissions 

In the shmop{2) and shmctl{2) system call descriptions, the per¬ 
mission required for an operation is given as "{token}", where 
"token" is the type of permission needed and is interpreted as 
follows: 


00400 

Read by user 

00200 

Write by user 

00060 

Read, Write by group 

00006 

Read, Write by others 
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shell 


shell program 
shell script 


signal 

single-user state 


special file 


Read and Write permissions on a shmid are granted to a process 
if one or more of the following are true: 

The process’s effective user ID is super-user. 

The process’s effective user ID matches shm_perm.[c]uid 

in the data structure associated with shmid and the 
appropriate bit of the “user” portion (0600) of 

shm_perm.mode is set. 

The process’s effective user ID does not match 
sem_perm.[c]uid, and either the process’s effective group 

ID matches sem_perm.[c]gid or sem_perm.[c]gid is in 

the process’s group access list, and the appropriate bit of 
the “group” portion (060) of sem_perm.mode is set. 

The process’s effective user ID does not match 
sem_perm.[c]uid, and the process’s effective group ID 
does not match sem_perm.[c]gid and neither is 

sem_perm.[c]gid in the process’s group access list, and 

the appropriate bit of the “other” portion (06) of 
sem_perm.mode is set. 

Otherwise, the corresponding permissions are denied. 

A shell is a command which functions as both a command inter¬ 
preter and an interpretive programming language. A shell is 
usually automatically invoked (via /etc/passwd)foreveryuser'w\\o 
in order to provide a user-interface to the HP-UX operating sys¬ 
tem. See sh{l), csh{l), or r5/i(l), and the tutorials supplied with 
your system for details. 

See shell script. 

A sequence of shell commands and shell programming language 
constructs stored in a file and invoked as a user command (pro¬ 
gram). No compilation is needed prior to execution, because the 
shell recognizes the commands and constructs that make up the 
shell programming language. A shell script is often called a shell 
program or a command file. See the shell programming article 
included in HP-UX Concepts and Tutorials. 

Signals are software interrupts sent to processes, informing them 
of special situations or events. They are frequently used to syn¬ 
chronize the operation of two or more processes. See signal{2) 
and kill{2). 

A condition of the HP-UX operating system in which the system 
console provides the only communication mechanism between the 
system and its user. By default, the Series 200 single-user state 
is state 1, and the Series 500 multi-user state is state 2. Do not 
confuse the single-user state, in which the software is limiting a 
multi-user system to a single-user communication, with a 
single-user system, which can never communicate with more 
than one fixed terminal. See multi-user state. 

Often called a device file, this is a file associated with an I/O 
device. Special files are read and written just like ordinary files, 
but requests to read or write result in activation of the associated 
device. Most standard special files reside in /dev; however. 
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special processes 


standard error 


standard input 


standard output 


stream 


sticky bit 


sub-directory 

subordinate directory 
super block 


network special files reside in /net^ and fifo special files can exist 
in any directory. 

Processes with certain (small) process ID’s are special. On a 
typical system, the ID’s of 0, 1, and 2 are assigned as follows: 
Process 0 is the scheduler. Process 1 is the initialization process 
init, and is the ancestor of every other process in the system. It 
is used to control the process structure. On paging systems with 
virtual memory process 2 is the paging daemon. 

On the Series 500, there is no process 0 and the scheduler does 
not exist as an identifiable entity. The paging demon also does 
not exist as an identifiable entity. 

The destination of error and special messages from a program. 
The standard error file is often called s^derr, and is automatically 
opened for writing on file descriptor 2 for every command 
invoked. By default, the user’s terminal is the destination of all 
data written to stderr, but it can be redirected elsewhere. 

The source of input data for a program. The standard input file 
is often called stdin, and is automatically opened for reading on 
file descriptor 0 for every command invoked. By default, the 
user’s terminal is the source of all data read from stdin, but it 
can be redirected from another source. 

The destination of output data from a program. The standard 
output file is often called stdout, and is automatically opened for 
writing on file descriptor 1 for every command invoked. By 
default, the user’s terminal is the destination of all data written 
to stdout, but it can be redirected elsewhere. 

A term most often used in conjunction with the standard I/O 
library routines documented in section 3 of this manual. A 
stream is simply a file pointer (declared as FILE *stream) 
returned by the fopen{3S) library routines. It may or may not 
have buffering associated with it (by default, buffering is 
assigned, but this may be modified with setbuJ(SS)). 

A single bit in the mode of every file in the file system. If set, 
then the data structure and heap storage for the text portion of 
the file is retained even if no process is currently attaching 
(using) to it. The objective is to reduce startup time of future 
processes that may use the same text file. Only the super-user 
can set the sticky bit. The sticky bit is read each time the file is 
executed (via ea:ec(2)). 

A directory that is one (or perhaps more) levels lower in the file 
system hierarchy than a given directory. Sometimes called a 
subordinate directory. 

See sub-directory. 

A block on each file system’s mass storage medium which 
describes the file system. The contents of the super-block vary 
between implementations. Refer to the System Administrator 
Manual supplied with your system, and the appropriate /s(5) 
entry for details. 
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super-user 


superior directory 
system call 


system console 


terminal affiliation 


terminal group 


The HP-UX system administrator. This user has access to all 
files, and can perform privileged operations. He has a real and 
effective user ID of 0, and, by convention, the user name of root. 

See parent directory. 

An HP-UX operating system kernel function available to the 
user through a high-level language (such as FORTRAN, Pascal, 
or C). Also called an "intrinsic" or a "system intrinsic". The 
available system calls are documented in section 2 of the HP-UX 
Reference manual. 

A keyboard and display (or terminal) given a unique status by 
HP-UX and associated with the special file /dev/console. All 
boot ROM or system loader error messages, HP-UX system error 
messages, and certain system status messages are sent to the sys¬ 
tem console. Under certain conditions (such as the single-user 
state), the system console provides the only mechanism for com¬ 
municating with HP-UX. See HP-UX Concepts and Tutorials 
and the System Administrator Manual provided with your system 
for details on configuration and use of the system console. 

The means by which a process group leader establishes an associ¬ 
ation between itself and a particular terminal. A terminal 
becomes afiiliated with a process group leader (and subsequently 
all processes created by the process group leader - see terminal 
group) whenever the process group leader executes (either 
directly or indirectly) an open{2) or creat{2) system call for that 
a terminal. Then, if the process which is executing open{2) or 
creat{2) is a process group leader, and if that process group 
leader is not yet afiiliated with a terminal, and if the terminal 
being opened is not yet afiiliated with a process group, the 
affiliation is established. 

An afiiliated terminal keeps track of its process group afiiliation 
by storing the process group’s process group ID in an internal 
structure. 

Two benefits are realized by terminal afiiliation. First, all signals 
sent from the terminal are sent to all processes in the terminal 
group. Second, all processes in the terminal group can perform 
I/O from/to the generic terminal driver /dev/tty, which 
automatically selects the affiliated terminal. 

Terminal afiiliation is broken with a terminal group when the 
process group leader terminates, after which the hangup signal is 
sent to all processes remaining in the process group. Also, if a 
process (which is not a process group leader) in the terminal 
group becomes a process group leader via the setpgrp{2) system 
call, its terminal afiiliation is broken. 

See process group, process group leader, terminal group, and 
setpgrp{2). 

A terminal group is a process group whose process group leader 
has established afiiliation with a particular terminal. Once a 
process group leader has established affiliation with a terminal, 
all processes in that process group created after the affiliation 
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tty group ID 
unit number 


volume number 


working directory 


zombie process 


are members of that terminal group. Processes existing before 
and during the time when affiliation is established do not inherit 
the affiliation, and are thus not part of the terminal group. A 
terminal group is sometimes called a tty group. 

This grouping is used to terminate a group of related process 
upon termination of one of the processes in the group; see exit {2) 
and signal{2). 

See process group, process group leader, terminal affiliation, and 
setpgrp{2). 

See terminal group. 

Part of an address used for devices. A number whose meaning is 
software- and device-dependent, but which is often used to 
specify a particular disc drive in a device with a multi-drive con¬ 
troller. See the System Administrator Manual supplied with your 
system for details. 

Part of an address used for devices. A number whose meaning is 
software- and device-dependent, but which is often used to 
specify a particular volume on a multi-volume disc drive. See 
the System Administrator Manual supplied with your system for 
details. 

Each process has associated with it the concept of a current 
working directory. For a shell, this appears as the directory in 
which you currently reside. This is the directory in which rela¬ 
tive path name (i.e. when a given path name does not begin with 
"/") searches begin. It is sometimes referred to as the current 
directory, or the current working directory. 

The state of a process where the only system resource allocated 
to it is a slot in the process table data structure. This state is 
arrived at when the process is being terminated. It is a harmless 
occurrence which rectifies itself the next time that the parent 
process waits. The ps{l) command lists zombie processes as 
“<defunct>”. 
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a641 . 

abort . 

abs . 

absolute value, floating point . 

absolute value, integer. 

access . 

access long integer data in machine-independent manner . 

access modes, change memory segment . 

access terminfo database . 

access utmp file entry . 

accessing discs, description of blocked/unblocked disc interface 

accounting commands, miscellaneous . 

accounting commands, overview . 

accounting commands, process . 

accounting: connect-time . 

accounting, convert binary wtmp records to ASCII . 

accounting, correct time/date stamps on wtmp records . 

accounting: daily . 

accounting file format . 

accounting files: merge or add total . 

accounting: generate disc usage data by user ID . 

accounting: process accounting . 

accounting, record login names and times. 

accounting records command summary . 

accounting: shell procedures . 

acctcms. 

acctcom . 

acctcon . 

acctdisk . 

acctdusg . 

acctmerg . 

accton . 

acctprc . 

acctsh . 

acctwtmp. 

acos . 

activity, terminate all current system activity . 

adb . 

add a swap device for interleaved paging/signalling . 

add backing store devices. 

add or change environment value . 

add or merge total accounting files . 

address space, allocate and free . 

address space, lock/unlock for process . 

addresses, get for program . 

adjust . 

admin . 

advance . 

advise OS about segment reference patterns . 

alarm.. 

alarm clock, set . 

allocate a block of memory . 

allocate and free address space . 

allocate backing store space to backing store device. 

allocate data segment space for process . 
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a.out file format, description of . a.out(5) 

append to an existing operating system . oscp(lM) 

appointments, reminder service for ... calendar(l) 

ar . ar(l) 

arc cosine function . trig(3M) 

arc sine function. trig(3M) 

arc tangent function . trig{3M) 

archive, conversion to new format . arcv(l) 

archive file format, description of. ar(5) 

archive file format, description of cpio archive file format . cpio(5) 

archive files on tape. tar(l) 

archive library, find ordering relation for . lorder(l) 

archive, table of contents format description . ranlib(5) 

archives and libraries, create and maintain. 

archives, copy out to media . cpio(l) 

archives, extract archive files from media . cpio(l) 

arcv . arcv(l) 

argument list handling facility, variable . varargs(7) 

argv, get next option letter from . getopt(3C) 

array, allocate memory space for . malloc(3C) 

array, print formatted data into. printf(3S) 

array, read and format data from. scanf(3S) 

as . as(l) 

asa . asa(l) 

ASA carriage control characters, interpret . asa(l) 

ascii . ascii (7) 

ASCII, convert base 64 ASCII to long integer. a641(3C) 

ASCII, convert binary wtmp records to . fwtmp(lM) 

ASCII, convert floating point value to . ecvt(3C) 

ASCII, convert non-ASCII to ASCII . conv(3C) 

ASCII, convert to numbers . atof(3C) 

asctime. ctime(3C) 

asin . trig(3M) 

assembler for MC68000 . as(l) 

assembler/linker executable output file, description of. a.out(5) 

assembly language, translate . atrans(l) 

assert . assert(3X) 

assign buffering to an open file . setbuf(3S) 

assistance, get for SCCS . help(l) 

assure sufficient signal stack space . sigspace(2) 

asynchronous terminal emulation. aterm(l) 

at . at(l) 

atan. trig(3M) 

atan2 . trig(3M) 

aterm . aterm(l) 

atoa . atof(3C) 

atof. atof(3C) 

atoi. atof(3C) 

atol . atof(3C) 

atrans . atrans(l) 

attributes, change program’s internal . chatr(l) 

automatically release blocked signals and wait for interrupt . sigpause(2) 

awk . awk(l) 

backing store devices, add/remove device from those available. vson(2) 

backing store devices, allocate backing store space to . vsadv(2) 
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backing store usage, advise system about. vsadv(2) 

backspaces and reverse line-feeds, interpret for nroff(l) . col(l) 

backup . backup(IM) 

backup Command Set 80 cartridge tape. tcio(l) 

backup or archive file system. backup(IM) 

banner . banner(l) 

banners, make using large letters . banner(l) 

base-64 ASCII, convert to long integer. a641(3C) 

basename . basename(l) 

baud rate, settings for terminal . fty{4) 

bcheckrc. brc(lM) 

bdiff . bdiff(l) 

Bell file system consistency check and interactive repair . biffsck(l) 

Bell file system, construct . bifmkfs(l) 

Bell file system debugger . biffsdb(l) 

Bell Interchange Format file utilities. bif(5) 

Berkeley compatibility for magnetic tape, description of . mt(4) 

bessel functions . bessel(3M) 

bfs . bfs(l) 

BIF directory, list . bifls(l) 

BIF directory, make . bifmkdir(l) 

BIF file, change mode of . bifchmod(l) 

BIF file copy. bifcp(l) 

BIF files or directories, remove . bifrm(l) 

bifchmod . bifchmod(l) 

bifchown. bifchown(l) 

bifcp . bifcp(l) 

bifdf . bifdf(l) 

biffind. biffind(l) 

biffls . biffls(l) 

biffsck. biffsck(l) 

biffsdb. biffsdb(l) 

bifmkdir . bifmkdir(l) 

bifmkfs . bifmkfs(l) 

bifrm. bifrm(l) 

big file scanner. bfs(l) 

binary search on a sorted table . bsearch(3C) 

bit bucket, special file equivalent to . null(4) 

block of memory, allocate . malloc(3C) 

block of memory, change size of . malloc(3C) 

block of memory, deallocate . malloc(3C) 

block signals . sigblock(2) 

block size, find for mounted file system . ustat(2) 

block special file, create. mknod(2), mknod(lM) 

blocked disc interface, description of. disc(4) 

blocked signals, release and wait for interrupt . sigpause(2) 

blocks, find number of free blocks for mounted file system . ustat(2) 

blocks, report number of free disc blocks . df(lM) 

boot area, allocate bytes for . sdfinit(lM) 

boot area, copy OS from one or more SDF boot areas to another. oscp(lM) 

boot area, set or get current settings for system parameters in . uconfig(lM) 

brc . brc(lM) 

break . sh(l) 

break value, get maximum for process . ulimit(2) 

break value, set or get . brk(2) 
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Permuted Index 


break-point debugging, enable for child process. ptrace(2) 

brk . brk(2) 

bsearch . bsearch(3C) 

buffered file I/O package, description of. stdio(3S) 

buffering, assign to open file . setbuf(3S) 

buffers, flush those associated with an open file . fclose(3S) 

byte offset of next I/O operation on file, set. fseek(3S) 

byte swapping. swab(3C) 

C compiler . cc(l) 

C compiler, preprocessor for . cpp(l) 

C flow graph, generate . cfiow(l) 

C preprocessor. cpp(l) 

C program checker/verifier . lint(l) 

C program, error message generator for.;. perror(3C) 

C program formatter . cb(l) 

cache buffers, specify size and number of. uconfig(lM) 

calendar . calendar(1) 

call another UNIX/HP-UX system . cu(l) 

calloc . malloc(3C) 

captoinfo. captoinfo(lM) 

carriage control characters, interpret ASA . asa(l) 

cartridge tape. Command Set 80 utility . tcio(l) 

cartridge tape initialization . mediainit(l) 

cartridge tape, perform input/output from/to. tcio(l) 

cartridge tape, unpack/extract files from Command Set 80 . upm(l) 

cat . cat(l) 

cat, compress, uncompress files . compact(l) 

catman . catman(lM) 

catread . catread(3C) 

cb . cb(l) 

cc . cc(l) 

ccat . compact (1) 

cd . cd(l), sh(l) 

cdc . cdc(l) 

ceil . fioor(3M) 

certify file system consistency . fsck(lM) 

certify SDF volume . sdfinit(lM) 

cfiow. cfiow(l) 

change bars, create file containing. diffmk(l) 

change data segment space allocation . brk(2) 

change delta commentary of SCCS delta . cdc(l) 

change file mode . chmod(l), chmod(2) 

change file owner or group . bifchown(l) 

change file owner or group. chown(l), chown(2) 

change group ID of user. newgrp(l), sh(l) 

change login password . passwd(l) 

change default login shell . chsh(l) 

change memory segment access modes . memchmd(2) 

change mode of a BIF file . bifchmod(l) 

change or add value to environment . putenv(3C) 

change or read real-time priority. rtprio(2) 

change or set real-time priority . rtprio(l) 

change program’s internal attributes . chatr(l) 

change root directory for a command . chroot(lM) 

change root directory for duration of command. chroot(l), chroot(2) 
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change SCCS file parameters . 

change size of previously-allocated block of memory . 

change system state . 

change to another user . 

change to different operating system or version. 

change working directory . 

character classification . 

character conversion, lower-case to upper-case . 

character conversion, non-ASCII to ASCII. 

character conversion, upper-case to lower-case . 

character count . 

character, description of special characters in terminal interface 

character, push back into input stream . 

character, read from buffered open file . 

character, search for in string . 

character sets, NLS . 

character size, settings for terminal . 

character special file, create . 

character, write on buffered open file or standard output . 

characters, count number contained in file. 

characters, process characters from regular expression. 

characters, translate into other characters . 

chatr . 

chdir . 

check C program . 

check file for accessibility . 

check file system consistency . 

check integrity of OS in SDF boot area(s) . 

check internal revision numbers of HP-UX files. 

check password and group files .. 

checklist, list of file systems to be checked by fsck(lM) . 

chgrp . 

child process, enable break-point debugging of. 

child process, time execution of .. 

child process, wait for termination of.... 

chmod . 

chown . 

chroot . 

chroot . 

chsh . 

chsys. 

classify characters for NLS . 

clean up uucp spool directory . 

clear . 

clear error indicator on open file. 

clear i-node by zeroing it out . 

clear terminal screen . 

clear x.25 switched virtual circuit . 

clearerr .. 

clock . 

clock, set/print time and date . 

close . 

close a file descriptor . 

close group file . 

close or flush a stream . 


. admin (1) 

. malloc(3C) 

. init(lM) 

. su(l) 

. chsys(lM) 

. cd(l), sh(l), chdir(2) 

. ctype(3C) 

. conv(3C) 

. conv(3C) 

. conv(3C) 

. wc(l) 

. tty(4) 

. ungetc(3S) 

. getc(3S) 

. string(3C) 

ascii(7), kana8(7), roman8(7) 

. tty (4) 

. mknod(2), mknod(lM) 

. putc(3S) 

. wc(l) 

. regexp (7) 

. tr(l) 

.. chatr(l) 

. chdir (2) 

. lint(l) 

. access(2) 

. fsck(lM) 

. osck(lM) 

. revck(lM) 

. pwck(lM) 

. checklist(5) 

. chown(l) 

. ptrace(2) 

. times(2) 

. sh(l) 

. chmod(l), chmod(2) 

. chown(l), chown(2) 

. chroot(l), chroot(2) 

.. chroot(lM) 

. chsh(l) 

. chsys(lM) 

. nl_ctype(3C) 

. uuclean(lM) 

. clear(l) 

. ferror(3S) 

. clri(lM) 

. clear(l) 

. clrsvc(lM) 

. ferror(3S) 

. clock(3C) 

. date(l) 

. close(2) 

. close(2) 

.. getgrent(3C) 

. fclose(3S) 
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close password file . getpwent(3C) 

close pipe between process and command . popen(3S) 

close-on-exec flag, get/set . fcntl(2) 

clri . clri(lM) 

clrsvc . clrsvc(lM) 

cmp . cmp(l) 

code portability between HP-UX implementations, typedefs for . model(5) 

code segments, specify maximum number of. uconfig(lM) 

col. col(l) 

collating sequence tables, NLS character set . col_seq_8(5), col_seq_16(5) 

collation, non-ASCII string, used by NLS . nl_string(3C) 

colon (:) command . sh(l) 

combine object files into program . ld(l) 

comm . comm(l) 

command, create/close pipe between process and command . popen(3S) 

command, execute from program. system(3S) 

command, execute on another system . uux(l) 

command, execute uucp commands on local system . uuxqt(lM) 

command, execute with different root directory . chroot(l), chroot(2) 

command interpreter, standard . sh(l) 

command line options, parse . getopt(l) 

command, report error information for . err(l) 

command, run at lower or higher priority . nice(l), nice(2) 

command, run immune to hangups, logouts, and quits . nohup(l) 

Command Set 80 Cartridge Tape Utility . tcio(l) 

command, set environment for . env(l) 

command substitution . sh(l) 

command summary; per-process accounting records . acctcms(lM) 

command, time the execution of ... time(l) 

commands, execute at specified date(s) and time(s) . at(l), cron(lM) 

commands, install in file system . install(lM) 

commands, process accounting . acctcom(l) 

common lines, find after comparing two files . comm(l) 

common logarithm . exp(3M) 

communication, establish interactive communication with another UNIX/HP-UX system . cu(l) 

compact . compact (1) 

compare two directories . dircmp(l) 

compare two files . bdiff(l), cmp(l), diff(l) 

compare two strings . string(3C) 

compare two versions of SCCS file . sccsdiff(l) 

compile . regexp (7) 

compiled term file format. term(5) 

compiler, C . cc(l) 

compiler development. yacc(l) 

compiler, FORTRAN 77 . fc(l), f77(l) 

compiler, Pascal. pc(l) 

compiler: terminfo. tic(lM) 

compiler-compiler . yacc(l) 

complementary error function and error function . erf(3M) 

compress and uncompress files, and cat them . compact(l) 

compress and uncompress files, and cat them . compact (1) 

concatenate, copy, and/or print files . cat(l) 

concatenate lines in one or more files . paste(l) 

concatenate two strings . string(3C) 

conditional expressions, evaluate and test . sh(l), test(l) 
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config . config(lM) 

configure an HP-UX system . config(lM) 

configure LP spooler system . mklp(lM) 

connect to remote terminal . dial(3C) 

connect-time accounting. acctcon(lM) 

constants and functions, math . math(7) 

construct a Bell file system . bifmkfs(l) 

construct file system on special file . mkfs(lM) 

construct new file system . newfs(lM) 

contents of directory, list . ls(l) 

context-free grammar, create. yacc(l) 

continue. sh(l) 

control characters, interpret ASA carriage . asa(l) 

control device . ioctl(2), stty(2) 

control-flow constructs, shell programming language . sh(l) 

conventional terminal names . term(7) 

convert archives to new format . arcv(l) 

convert between 3-byte integers and long integers . 13tol(3C) 

convert between long and base-64 ASCII . a641(3C) 

convert binary wtmp records into ASCII . fwtmp(lM) 

convert date and time to ASCII . ctime(3C) 

convert floating point value to ASCII string . ecvt(3C) 

convert, reblock, translate, and copy a (tape) file . dd(l) 

convert string to double-precision integer . strtod{3C) 

convert string to integer. strtol(3C) 

convert tape file . dd(l) 

convert termcap description to terminfo description . captoinfo(lM) 

copy an open file descriptor . dup(2), fcntl(2) 

copy, concatenate, and/or print files . cat(l) 

copy files between two systems . uucp(l), uuto(l) 

copy files out to media. cpio(l) 

copy files while simultaneously editing them . sed(l) 

copy line from standard input to standard output . line(l) 

copy, link, or move files . cp(l) 

copy operating system from one or more SDF boot areas to another . oscp(lM) 

copy string. string(3C) 

copy tape file. dd(l) 

copy to or from BIF files . bifcp(l) 

copy to or from LIF files . lifcp(l) 

core image, examine and/or modify for child process . ptrace(2) 

core image file, description of. core(5) 

cos . trig{3M) 

cosh . sinh(3M) 

cosine function . trig(3M) 

cosine, hyperbolic . sinh(3M) 

cp . cp(l) 

cpio . cpio(l) 

cpio archive format, description of. cpio(5) 

cpio archives, unpack/extract from 5.25" flexible discs . upm(l) 

cpio archives, unpack/extract from Command Set 80 cartridge tape . upm(l) 

cpp . cpp(l) 

cpset . cpset(lM) 

CPU type . machid(l) 

creat . creat(2) 

create a directory . mkdir(l) 
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create a directory file . 

create a name for a temporary file . 

create a new process . 

create a special file entry . 

create an interprocess channel . 

create and open temporary file . 

create cat files for the manual . 

create delta (change) for SCCS file. 

create device files. 

create directory, block/character special, fifo, or ordinary file 

create encryption key . 

create libraries, archives. 

create link to file . 

create message catalog file for modification. 

create mnttab table. 

create new file, overwrite existing file . 

create new operating system from ordinary files . 

create or change parameters of SCCS files . 

create unique file name . 

creation mask, get/set for file . 

cron. 

crontab . 

CRT, facilitate viewing of continuous text on . 

CRT, information about graphics devices with . 

CRT screen handling and optimization routines . 

crypt . 

C-source error messages into a file . 

ct . 

ctermid. 

ctime . 

cu . 

current directory, print name of .. 

current events, print . 

current user id . 

current user in utmp file, find . 

current working directory, change . 

current working directory pathname . 

current working directory, print name of. 

curses .. 

cursor handling and optimization routines . 

cuserid. 

cut . 

cut out selected fields of each line of a file . 

daily accounting ... 

data access, long integer, machine independent . 

data base, relational data base operator.. 

Data Encryption Standard . 

data segment, change space allocation for. 

data segments, specify maximum number of. 

data types, include file defining data types for system code .. 

database access. 

datacomm, accept/reject files received through uucp or uuto 

datacomm, copy files between two systems. 

datacomm, execute command on another system . 

datacomm, list of known system names . 


. mkdir(2) 

. tmpnam(3S) 

. fork(2) 

. mknod(5) 

... Pipe(2) 

. tmpfile(3S) 

. catman(lM) 

.. delta(l) 

. mkdev(lM) 

. mknod(2), mknod(lM) 

. makekey(lM) 

. ar{l) 

. link(lM), link(2) 

. findmsg(l) 

. setmnt(lM) 

. creat(2) 

. oscp(lM) 

. admin(l) 

. mktemp(3C) 

sh(l), umask(l), umask(2) 

.. cron(lM) 

. crontab(l) 

.. more(l) 

. graphics (4) 

.. curses(3X) 

. crypt (3C) 

. mkstr(l) 

. ct(4) 

. ctermid(3S) 

. ctime(3C) 

. cu(l) 

. pwd(l) 

. news(l) 

. whoami(l) 

. ttyslot(3C) 

. cd(l), sh(l), chdir(2) 

. getcwd(3C) 

. pwd(l) 

. curses (3X) 

. curses (3X) 

. cuserid(3S) 

. cut(l) 

. cut(l) 

. runacct(lM) 

. sputl(3X) 

. join(l) 

. crypt (3C) 

. brk(2) 

. uconfig(lM) 

. types(7) 

. query (1) 

. uuto(l) 

. uucp(l), uuto(l) 

. uux(l) 

. uucp(l) 
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datacomm, log of uucp and uux transactions . 

date . 

date and time, convert to ASCII string. 

date and time, get more precisely . 

date, get/set. 

date, set. 

date, set and/or print. 

dates, reminder service for important . 

daylight. 

daylight saving time, time corrected for. 

dd . 

deallocate a block of memory . 

debug damaged file system . 

debugger . 

debugging, enable break-point debugging for child process. 

decompiler: terminfo . 

delays, settings and controls for terminal output ... 

delta . 

delta, add to SCCS file . 

delta, change commentary of SCCS .. 

delta, inform user of any deltas being created for specific SCCS file 

delta, remove from SCCS file . 

demand loadable, set for program . 

deroff. 

DES password encryption . 

description of environment . 

description of /etc/passwd, pwd.h files . 

description of group file. 

description of magic.h and magic numbers. 

description of OS management commands . 

descriptor, close file . 

descriptor, copy/duplicate file . 

descriptor, get value of file . 

device, description of hpib interface to . 

device driver, select virtual device driver . 

device drivers, list . 

device file, create block/character . 

device files, create . 

device files, perform functions on . 

device names, pack/unpack for mknod(2) . 

device I/O library . 

devices, backing store. 

devices, information about those with graphics crt’s . 

devnm . 

df. 

diagnostics, add to program . 

dial . 

dial out to a remote terminal. 

dialup security control . 

diff . 

differences between files, mark . 

differential file comparison, 3-way . 

diffh . 

diffmk. 

digitizer, description of hpib interface to . 


. uucp(l) 

. date(l) 

. ctime(3C) 

. ftime(2) 

. gettimeofday(2) 

. stime(2) 

. date(l) 

. calendar (1) 

. ctime(3C) 

. ctime(3C) 

. dd(l) 

. malloc(3C) 

. fsdb(lM) 

. adb(l) 

. ptrace(2) 

. untie (IM) 

. tty(4) 

. delta(l) 

. delta(l) 

. cdc(l) 

. sact(l) 

. rmdel(l) 

. chatr(l) 

. deroff(l) 

. crypt(3C) 

. environ(7) 

. passwd(5) 

. group(5) 

. magic(5) 

. osmgr(lM) 

. close(2) 

. dup(2), fcntl(2) 

. ferror(3S) 

. hpib(4) 

. uconfig(lM) 

. Isdev(l) 

. mknod(2), mknod(lM) 

. mkdev(lM) 

.. ioctl(2), stty(2) 

.. mknod(5) 

gpio_*(3I), hpib_*(3I), io_*(3I) 

. vson(2) 

. graphics(4) 

. devnm(lM) 

. df(lM) 

. assert(3X) 

. dial(3C) 

. dial(3C) 

. dialups(5) 

. diff(l) 

. diffmk(l) 

. diff3(l) 

. diff(l) 

. diffmk(l) 

. hpib(4) 
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dircmp. dircmp(l) 

directory, change root for duration of command. chroot(l), chroot(2) 

directory, change working . cd(l), sh(l), chdir(2) 

directory clean-up for uucp spool directory . uuclean(lM) 

directory, compare two . dircmp(l) 

directory, create. mkdir(l), mknod(2) 

directory, description of internal SDF format of. dir(5) 

directory, extract from path name . basename(l) 

directory, list contents of. ls(l) 

directory, list contents of LIF . lifts (1) 

directory, move. mvdir(lM) 

directory, print name of current working. pwd(l) 

directory, remove. rm(l) 

directory, remove . rmdir(2) 

dirname . basename(l) 

disc blocks, report number of free . df(lM) 

disc description file . disktab(5) 

disc drivers, information about blocked/unblocked interface. disc(4) 

disc initialization . mediainit(l) 

disc storage, preallocate . prealloc (1) 

disc usage accounting by user ID . diskusg(lM) 

disc usage, summarize . du(l) 

disc, write current contents of memory to . sync(2), sync(l) 

diskusg . diskusg(lM) 

display buffering, specify number of pages of. uconfig(lM) 

documentation, on-line . man(l) 

documents, print using mm macros. mm(l) 

dot (.) command. sh(l) 

drand48 . drand48(3C) 

driver, information about blocked/unblocked disc interface . disc (4) 

drivers, list device . Isdev(l) 

du . du(l) 

dump, octal or hexadecimal. od(l) 

dumpmsg . dumpmsg(l) 

dup . dup(2) 

dup2 . dup2(2) 

duplicate an open file descriptor . dup(2), fcntl(2) 

duplicate open file descriptor. dup2(2) 

e . ex(l) 

echo. echo(l) 

echo (print) arguments after shell interpretation . echo(l) 

ecvt . ecvt(3C) 

ed . ed(l) 

edata. end(3C) 

edit . ex(l) 

editing activity, print for SCCS file . sact(l) 

editor, stream text . sed(l) 

editor, text ... ed(l), ex(l) 

editor, visual text . vi(l) 

effective current user id. whoami(l) 

effective user/group ID’s, get for process . getuid(2) 

egrep . grep(l) 

EMS . ems(2) 

EMS, description of. ems(2) 

emulation of asynchronous terminal . aterm(l) 
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enable swapping and paging . swapon(lM) 

encrypt passwords . crypt(3C) 

encryption key, generate . makekey(lM) 

end . end(3C) 

endgrent . getgrent(3C) 

endpwent. getpwent(3C) 

env . env(l) 

environment, description of parameters and usage . sh(l), environ(7) 

environment, install parameters in . sh(l) 

environment, print current . env(l) 

environment, set for duration of one command . env(l) 

environment, set up at login time. profile(5) 

environment variable, get value of . getenv(3C) 

EOF (end-of-file) character, description of . tty (4) 

EOF, indicate receipt of when reading file . ferror(3S) 

EOL (end-of-line) character, description of . tty(4) 

eqn, tbl, nroff, troff constructs, remove from text . deroff(l) 

erase character, description of . tty(4) 

erf . erf(3M) 

erfc . erf(3M) 

err . err(l) 

errfile . errfile(5) 

errinfo . errinfo(2) 

errinfo, report value for last command failure. err(l) 

errno . errno(2) 

errno, report value for last command failure. err(l) 

ERROR . regexp (7) 

error function and complementary error function . erf(3M) 

error handling, mathematical . matherr(3M) 

error indicator. errinfo(2) 

error indicator for system calls. errno(2) 

error indicator, reset status of . ferror(3S) 

error indicator while reading file . ferror(3S) 

error information on last command failure . err(l) 

error logging file for system . errfile(5) 

error message generator from C programs . perror(3C) 

etext . end(3C) 

eval . sh(l) 

evaluate arguments as an expression . expr(l) 

ex . ex(l) 

examine text, facilitate on soft-copy terminals . more(l) 

exec . sh(l), exec(2) 

execl ... exec(2) 

execle. exec (2) 

execlp . exec(2) 

executable file, extract symbol table (name list) entries from . nlist(3C) 

executable file, get size of . size(l) 

executable linker/assembler output file, description of. a.out(5) 

execute a file in current process . exec(2) 

execute command at lower or higher priority . nice(l), nice(2) 

execute command immune to hangups, logouts, and quits . nohup(l) 

execute command on another system . uux(l) 

execute command using different root directory . chroot(l) 

execute commands at specified date(s) and time(s) . at(l), cron(lM) 

execute commands from file . sh(l) 
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execute new program in existing process . sh(l), exec(2) 

execute process with real-time priority. rtprio(l) 

execute HALGOL programs . opx25(lM) 

execute uucp commands on local system . uuxqt(lM) 

execute work requests on remote system . uucico(lM), uux(l) 

execution profile, create for program . profil(2), monitor(3C) 

execution, suspend process execution for time interval . sleep(l), sleep(3C) 

execv . exec (2) 

execve . exec (2) 

execvp . exec (2) 

—exit . exit (2) 

exit . sh(l), exit(2) 

exit from enclosing for or while loop . sh(l) 

exp . exp(3M) 

expand . expand(1) 

expand tabs to spaces, and vice versa . expand(l) 

exponent, raise 2 to a power . frexp(3C) 

exponential function . exp(3M) 

export . sh(l) 

expr. expr(l) 

expreserve. ex(l) 

expression, evaluate arguments as . expr(l) 

exrecover . ex(l) 

Extended Memory System description . ems(2) 

external symbols, examine execution profile for . prof(l) 

extract entries from symbol table (name list) of executable file . nlist(3C) 

extract error messages from C source into a file. mkstr(l) 

extract files from 5.25" flexible discs . upm(l) 

extract files from Command Set 80 cartridge tape archives . upm(l) 

extract files from media . cpio(l) 

extract portions of path names . basename(l) 

f77 . fc(l) 

f77 . see fc(l) 

fabs . floor(3M) 

false . true(l) 

fc . fc(l) 

fclose. fclose(3S) 

fcntl . fcntl(2) 

fcntl(2), description of requests and arguments for . fcntl(7) 

fcntl.h, description of . fcntl(7) 

fcvt . ecvt(3C) 

fdopen. fopen(3S) 

feof . ferror(3S) 

ferror . ferror(3S) 

fflush. fclose(3S) 

fgetc . getc(3S) 

fgets . gets(3S) 

fgrep . grep(l) 

fifo special file, create .. mknod(2), mknod(lM) 

file, assign another file name to already open file . fopen(3S) 

file, assign buffering to open . setbuf(3S) 

file attributes file, description of. fs(5) 

file, buffered read from . fread(3S) 

file, buffered write to . fread(3S) 

file, change group ID of . chown(l), chown(2) 
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file, change mode of . 

file, change owner . 

file, change permission bits . 

file, check revision number for . 

file, close a buffered open file . 

file comparison, three-way differential . 

file control . 

file control constants, file containing definitions of. 

file, copy LIF in or out . 

file, copy to tape while performing certain conversions . 

file, count words, lines, and characters contained therein . 

file, create and open temporary . 

file, create device/special . 

file, create or overwrite ordinary . 

file, create or remove link to/from . 

file, create ordinary . 

file creation mask, set . 

file, description of buffered I/O . 

file, description of password file, /etc/passwd . 

file, description of SCCS file format . 

file descriptor, assign stream to . 

file descriptor, close . 

file descriptor, copy/duplicate . 

file descriptor, create file pointer using . 

file descriptor, determine if associated with terminal . 

file' descriptor, get value of . 

file, determine accessibility of . 

file, error logging file for system . 

file, find and/or remove duplicate lines in . 

file, find spelling errors in. 

file format, per-process accounting. 

file, generate name for temporary . 

file, get information about . 

file, get/set status fiags for. 

file, indicate the occurrence of an error while reading. 

file, indicate when EOF is encountered when reading from . 

file, locate in file system . 

file, move to new position in . 

file name, create file name vs. i-node list . 

file name, create unique . 

file name, extract from path name . 

file name, find special file for mounted file system on which file lies 

file name, generate for temporary file . 

file name, generate for terminal . 

file, open for reading or writing . 

file, open with assigned buffering . 

file owner or group, change . 

file pointer, create using file descriptor . 

file pointer, move read/write (seek) . 

file pointer, obtain for file . 

file pointer, re-assign to another file. 

file, print last part of . 

file, put line length specifications in text files . 

file, put margin specifications in text files. 

file, put tab specifications in text files . 


. chmod(l), chmod(2) 

. chown(l), chown(2) 

. chmod(l), chmod(2) 

. revck(lM) 

. fclose(3S) 

. diff3(l) 

. fcntl(2) 

. fcntl(7) 

. lifcp(l) 

. dd(l) 

. wc(l) 

. tmpfile(3S) 

. mkdev(lM) 

. creat(2) 

link(lM), link(2), unlink(2) 

. mknod(2) 

sh(l), umask(l), umask(2) 

. stdio(3S) 

. passwd(5) 

. sccsfile(5) 

. fopen(3S) 

. close(2) 

. dup(2), fcntl(2) 

. fopen(3S) 

. ttyname(3C) 

. ferror(3S) 

. access(2) 

. errfile(5) 

. uniq(l) 

. spell(l) 

. acct(5) 

. tmpnam(3S) 

. stat(2) 

. fcntl(2) 

. ferror(3S) 

. terror(3S) 

. find(l) 

. lseek(2) 

. ncheck(lM) 

. mktemp(3C) 

.. basename(l) 

. devnm(lM) 

.. tmpnam(3S) 

. ctermid(3S) 

. open(2) 

. fopen(3S) 

. bifchown(l) 

. fopen(3S) 

. lseek(2) 

. fopen(3S) 

. fopen(3S) 

. tail(l) 

. fspec(5) 

. fspec(5) 

. fspec(5) 
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Permuted Index 


file, read and execute commands from . 

file, read and format data from .. 

file, read character from. 

file, read from . 

file, read string from . 

file, read word from . 

file, remove . 

file, remove a LIF . 

file, remove extra new-line characters from. 

file, remove selected fields from each line in . 

file, remove selected table column entries from . 

file, rename LIF . 

file, rewind before next I/O operation . 

file scanner, big. 

file, search contents of for specified string(s) . 

file, set/clear set-user-ID, set-group-ID, sticky bits . 

file size limit, get for process . 

file, sort contents of . 

file, split into pieces. 

file system, backup file system on cpio archive . 

file system (Bell) consistency check and interactive repair 

file system (Bell) debugger . 

file system consistency check and interactive repair. 

file system, construct on special file . 

file system debugger . 

file system descriptor file entry. 

file system, find special file associated with . 

file system hierarchy . 

file system, install commands in . 

file system, list of those to be checked by fsck(lM) . 

file system, mount or unmount .. 

file system name, get for mounted. 

file system pack name, get for mounted . 

file system shutdown status . 

file system, table of mounted file systems . 

file, system’s "bit bucket" special file . 

file transfer: XMODEM protocol . 

file transfers: KERMIT-protocol . 

file tree walk . 

file, update access/modification/change times of. 

file utilities. Bell Interchange Format . 

file, write character onto . 

file, write formatted data onto . 

file, write LIF volume header on . 

file, write string onto . 

file, write to . 

file, write word onto . 

file-creation mode mask, get/set . 

fileno . 

files, archive on tape . 

files, check password and group files . 

files, compare two . 

files, compare two and create change bars. 

files, compare two and find lines common to both . 

files, compare two and find lines unique to each . 


. sh(l) 

. scanf(3S) 

. getc(3S) 

. read(2) 

. gets(3S) 

. getc(3S) 

. rm(l) 

. lifrm(l) 

. rmnl(l) 

. cut(l) 

. cut(l) 

. lifrename(l) 

. fseek(3S) 

. bfs(l) 

. grep(l) 

. chmod(l), chmod(2) 

. ulimit(2) 

. sort(l) 

. split(l) 

. backup (IM) 

. biff‘sck(l) 

. biffsdb(l) 

. fsck(lM) 

. mkfs(lM) 

. fsdb(lM) 

. getfsent(3X) 

. devnm(lM) 

. hier(7) 

. install(IM) 

. checklist (5) 

mount(lM), mount(2), umount(2) 

.. ustat(2) 

. ustat(2) 

. fsclean(lM) 

. mnttab(5) 

. null(4) 

. umodem(lM) 

. kermit(lM) 

. ftw(3C) 

. touch(l), utime(2) 

. bif(5) 

. putc(3S) 

. printf(3S) 

. lifinit(l) 

. puts(3S) 

. write(2) 

. putc(3S) 

. umask(l), umask(2) 

. ferror(3S) 

. tar(l) 

. pwck(lM) 

. bdiff(l), cmp(l), diff(l) 

. diffmk(l) 

. comm(l) 

. comm(l) 
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Permuted Index 


files, concatenate two or more . cat(l) 

files, copy . cat(l) 

files, copy and simultaneously edit . sed(l) 

files, copy between two systems . uucp(l), uuto(l) 

files, copy out to media. cpio(l) 

files, description of /etc/profile and $HOME/.profile . profile(5) 

files, extract from media . cpio(l) 

files, format and print. pi'(l) 

files, merge lines in one or more . paste(l) 

files, move, link, or copy . cp(l) 

files, print . cat(l) 

files, unpack/extract from 5.25" fiexible discs ... upm(l) 

files, unpack/extract from Command Set 80 cartridge tape archives. upm(l) 

filter reverse line-feeds and backspaces . col(l) 

find . find(l) 

find current user slot in utmp file... tty slot (3C) 

find duplicate lines in file . uniq(l) 

find files . find(l) 

find files in a BIF system ... biffind(l) 

find name of a terminal . ttyname(3C) 

find strings for inclusion in message catalog. findstr(l) 

findmsg . findmsg(l) 

findstr . findstr(l) 

fix manual pages for faster viewing with man(l) . fixman(l) 

fixman . fisman(l) 

fiag, get/set close-on-exec. fcntl(2) 

fiags, mapping pwb/V6 UNIX terminal flags into current HP-UX . tty(4) 

flags, set shell . sh(l) 

flexible discs, unpack/extract files from . upm(l) 

floating point number, split into integer and fractional parts . frexp(3C) 

floating point to ASCII conversion . ecvt(3C) 

floor . floor(3M) 

flow graph, C, generate . cflow(l) 

flush buffers associated with an open file . fclose(3S) 

fmod . floor(3M) 

fold long lines for finite-width output device . fold(l) 

fopen. fopen(3S) 

for loop, exit from enclosing . sh{l) 

for loop, resume the next iteration of . sh(l) 

fork . fork(2) 

format and print files. ?!■(!) 

format C program . cb(l) 

format, compiled term file. term(5) 

format data into string. printf(3S) 

format data on buffered open file . printf(3S) 

format data on standard output . printf(3S) 

format, nlist structure . nlist(5) 

format of an i-node, description of... inode(5) 

format of a.out file, description of . a.out(5) 

format of core image file, description of . core(5) 

format of cpio archive, description of. cpio(5) 

format of library/archive file, description of . ar(5) 

format of SCCS file, description of . sccsfile(5) 

format, privileged values. privgrp(5) 

format SDF volume. sdfinit(lM) 
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Permuted Index 


format specifications, put in text file . 

format tables for nroff or troff . 

format text . 

formatted output from varargs argument list .. 

formatted output with numbered arguments . 

formatter, text, simple. 

formatting text with the man macros. 

formatting text with the mm macros . 

FORTRAN 77 compiler . 

fprintf. 

fputc . 

fputs . 

fread. 

free . 

free blocks, find for mounted file system . 

free disc blocks, report number of . 

free disc blocks, report number of. 

free i-nodes, find for mounted file system . 

free memory space . 

freopen. 

frexp . 

fscanf. 

fsck . 

fsck . 

fsck(lM), list of file systems to be checked by . 

fsclean . 

fsdb . 

fseek . 

fstat . 

fstat(2)/stat(2), description of structure returned by these calls 

ftell . 

ftime . 

ftw... 

functions and constants, math . 

fwrite. 

fwtmp . 

gamma. 

gcvt . 

gene at . 

general terminal interface. 

generate a formatted message-catalog file . 

generate C flow graph . 

generate encryption key . 

generate uniformly-distributed pseudo-random numbers . 

get . 

get date and time more precisely . 

get entries from symbol table (name list) of executable file . 

get file system descriptor file entry. 

get group access list .. 

get message from a catalog . 

get message queue . 

get name of current host . 

get password file entry . 

get pathname of current working directory. 

get real/effective user, real/effective group IDs . 


. fspec(5) 

. tbl(l) 

. nroff(l) 

. vprintf(3S) 

. printmsg(3C) 

. adjust(l) 

. man(7) 

. mm (7) 

... fc(l),f77(l) 

. printf(3S) 

. putc(3S) 

. puts(3S) 

. fread (3S) 

.... malloc(3C) 

. ustat(2) 

. bifdf(l) 

. df(lM) 

.. ustat(2) 

.... memallc(2) 

. fopen(3S) 

.. frexp(3C) 

. scanf(3S) 

. fsck(lM) 

. fsck(lM) 

. checklist (5) 

... fsclean(lM) 

. fsdb(lM) 

.. fseek(3S) 

. stat(2) 

. stat(7) 

. fseek(3S) 

. ftime(2) 

. ftw(3C) 

. math(7) 

. fread (3S) 

.... fwtmp (IM) 
... gamma (3M) 

. ecvt(3C) 

. gencat(l) 

. termio(4) 

. gencat(l) 

.. cflow(l) 

. makekey(lM) 
... drand48(3C) 

. get{l) 

. ftime(2) 

. nlist(3C) 

... getfsent(3X) 
.. getgroups(2) 
.... getmsg(3C) 

. msgget(2) 

gethostname(2) 
. getpwent(3C) 

. getcwd(3C) 

. getuid(2) 
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Permuted Index 


get set of semaphores . semget(2) 

get shared memory segment . shmget(2) 

get special attributes for group . getprivgrp(l) 

get X.25 line . getx25(lM) 

getc . getc(3S) 

GETC . regexp(7) 

getchar. getc(3S) 

getcwd . getcwd(3C) 

getegid. getuid(2) 

getenv . getenv(3C) 

geteuid . getuid(2) 

getfsent . getfsent(3X) 

getgid . getuid(2) 

getgrent . getgrent(3C) 

getgrgid . getgrent(3C) 

getgrnam . getgrent(3C) 

getgroups . getgroups(2) 

gethostname . gethostname(2) 

getitimer . getitimer(2) 

getlogin . getlogin(3C) 

getmsg . getmsg(3C) 

getmsg, insert calls using findstring output . insertmsg(l) 

getopt. getopt(l) 

getopt . getopt(3C) 

getpass . getpass(3C) 

getpgrp . getpid(2) 

getpid . getpid(2) 

getppid . getpid(2) 

getprivgrp. getprivgrp(l), getprivgrp(2), setprivgrp(lM), privgrp(5) 

getpw . getpw(3C) 

getpwent . getpwent(3C) 

getpwnam... getpwent (3C) 

getpwuid . getpwent(3C) 

gets . gets(3S) 

get/set date and time. gettimeofday(2) 

get/set special attributes for group . getprivgrp(2) 

get/set value of interval timer. getitimer(2) 

gettimeofday . gettimeofday(2) 

getty . getty(lM) 

getuid . getuid(2) 

getut. getut(3C) 

getw . getc(3S) 

getx25 . getx25(lM) 

gmtime. ctime(3C) 

goto, non-local. setjmp(3C) 

grammar, create context-free. yacc(l) 

graphics devices, information for those with crt’s. graphics(4) 

grep . grep(l) 

group . group(5) 

group access list, set . setgroups(2) 

group, change ID of user. newgrp(l) 

group file, close . getgrent(3C) 

group file, description of /etc/group. group(5) 

group file, read one line from . getgrent(3C) 

group file, rewind . getgrent(3C) 
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Permuted Index 


group file, search for matching group ID . getgrent(3C) 

group file, search for matching group name . getgrent(3C) 

group ID, change for file . chown(l), chown(2) 

group ID, change for user . newgrp(l), sh(l) 

group ID, get for process . getpid(2) 

group ID, print . id(l) 

group ID, search group file for matching . getgrent(3C) 

group ID, set . setuid(2) 

group ID, set for process . setpgrp(2) 

group memberships, show . groups(1) 

group name, search group file for matching . getgrent(3C) 

group/password file checkers . pwck(lM) 

groups . groups (1) 

group special attributes, get. getprivgrp(l) 

group special attributes, set . setprivgrp(lM) 

grpck . pwck(lM) 

grp.h . group(5) 

gsignal . ssignal(3C) 

gtty . stty(2) 

handling facility, variable argument list . varargs(7) 

hangups, run command immune to . nohup(l) 

hardware name, get . uname(l), uname(2) 

hardware trap numbers, list of . trapno(2) 

hash search tables . hsearch(3C) 

header, write LIF volume on file . lifinit(l) 

heap size, change for program . chatr(l) 

help . help(l) 

help, get for SCCS routines . help(l) 

hexadecimal, octal dump . od(l) 

hier . hier(7) 

hierarchy, file system . hier(7) 

host name, get . gethostname(2) 

host name, set. sethostname(2) 

host system, set/print name of current . hostname (1) 

hostname. hostname (1) 

hpib interface, description of . hpib(4) 

hpnls . hpnls(7) 

HP-UX implementations, conditional compilation depending on . model(5) 

HP-UX implementations, definition of constants which identify . model(5) 

HP-UX machine identification . model(5) 

HP-UX revision information, get. revision(l) 

HP-UX version name, get . uname(l), uname(2) 

hsearch . hsearch(3C) 

hyperbolic functions . sinh(3M) 

hypot . hypot(3M) 

hypotenuse, function for calculating . hypot (3M) 

id . id(l) 

ID’s, set user and group . setuid(2) 

init . init(lM) 

INIT . regexp(7) 

init(lM), control information for . inittab(5) 

initgroups . initgroups(3C) 

initialization of system state and processes . init(lM) 

initialize group access list. initgroups (3C) 

initialize hard disc, flexible disc, or cartridge tape media . mediainit(l) 
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Permuted Index 


initialize SDF volume . sdfinit(lM) 

initialize terminal type and mode on login . tset(l) 

inittab . inittab(5) 

i-node, clear i-node by zeroing it out. clri(lM) 

i-node, description of i-node format . inode(5) 

i-node, enable access to i-node for file system repair. fsdb(lM) 

i-nodes, create file name vs. i-node list . ncheck(lM) 

i-nodes, find number of free i-nodes in mounted file system . ustat(2) 

input and format data from buffered open file . scanf(3S) 

input and format data from standard input . scanf(3S) 

input and format data from string . scanf(3S) 

input commands to shell . sh(l) 

input control, description of input control for terminal . tty(4) 

input/output between process and command . popen(3S) 

input/output, description of buffered file . stdio(3S) 

input/output operation, get current byte offset of. fseek(3S) 

input/output operation, reposition next . fseek(3S) 

input/output, output character/word to open file or standard output . putc(3S) 

input/output, push character back into input stream . ungetc(3S) 

input/output redirection. sh(l) 

input/output, write string to open file or standard output. puts(3S) 

insert calls to getmsg using findstring output. insertmsg(l) 

install . install(lM) 

install commands into file system . install(lM) 

install object files in binary directories. cpset(lM) 

integer, get largest integer smaller than x . floor(3M) 

integer, get smallest integer larger than x. floor(3M) 

integers, convert between 3-byte and long . 13tol(3C) 

integer trap control . intrapoff(3M) 

integrity check of operating system in SDF boot area(s) . osck(lM) 

interactive IMAGE database access . query(l) 

interactively write (talk) to another user . write(l) 

interface, description of hpib . hpib(4) 

interface to blocked/unblocked disc, description of . disc(4) 

interface to terminal I/O, description of. tty(4) 

interleave factor, establish for SDF volume. sdfinit(lM) 

interprocess communication, create . pipe(2) 

inter-process communication facilities status . ipcs(l) 

inter-process communication routines . stdipc(3C) 

interrupt character, description of . tty (4) 

intrapoff . intrapoff(3M) 

I/O between process and command . popen(3S) 

I/O, description of buffered file . stdio(3S) 

I/O operation, get current byte offset of. fseek(3S) 

I/O operation, reposition next . fseek(3S) 

I/O, output character/word to open file or standard output. putc(3S) 

I/O, push character back into input stream . ungetc(3S) 

I/O redirection . sh(l) 

I/O; GPIO routines (device I/O library) . gpio_*(3I) 

I/O; HP-IB routines (device I/O library) . hpib_*(3I) 

I/O; I/O routines (device I/O library) . io_*(3I) 

I/O, write string to open file or standard output . puts(3S) 

ioctl . ioctl(2) 

ioctl(2) system calls, description of. tty(4) 

iomap . iomap(4) 
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Permuted Index 


ipcrm. ipcrin(l) 

ipcs . ipcs(l) 

isalnum . ctype(3C) 

isalpha. ctype(3C) 

isascii . ctype(3C) 

isatty . ttyname(3C) 

iscntrl . ctype(3C) 

isdigit . ctype(3C) 

isgraph . ctype(3C) 

islower. ctype(3C) 

isprint . ctype(3C) 

ispunct . ctype(3C) 

isspace. ctype(3C) 

issue identification file . issue(5) 

isupper . ctype(3C) 

isxdigit . ctype(3C) 

jO . bessel(3M) 

jl . bessel(3M) 

jn . bessel(3M) 

join . join(l) 

join, perform join of two data base relations . join(l) 

kanaS . kana8(7) 

kermit . kermit(lM) 

key, generate encryption . makekey(lM) 

kill . kill(l) 

kill character, description of . tty(4) 

killall . killall(lM) 

1 . ls(l) 

13tol . 13tol(3C) 

164a . a641(3C) 

langid . langid(7) 

langinfo . langinfo(3C) 

language identification variable . langid(7) 

language information. langinfo (3C) 

last-accessed time, update for file.. touch(l), utime(2) 

last-changed time, update for file . touch(l) 

last-modified time, update for file . touch(l), utime(2) 

Id . ld(l) 

Idexp . frexp(3C) 

leave . leave(l) 

length of string, get . string{3C) 

lex . lex(l) 

lexical analysis of text, generate programs for . lex(l) 

libraries and archives, create and maintain. ar(l) 

library file format, description of . ar(5) 

library file format, description of cpio archive format . cpio(5) 

library, find ordering relation for object . lorder(l) 

library, table of contents format description . ranlib(5) 

LIF directory, list contents of. lifis(l) 

LIF file, remove . lifrm(l) 

LIF file, rename . lifrename(l) 

LIF files, copy in or out . lifcp(l) 

LIF volume header, write on file . lifinit(l) 

lifcp . lifcp(l) 

lifinit . lifinit(l) 


- 20 - 



























































Permuted Index 


lifts. lifts(l) 

lifrename. lifrename(l) 

lifrm. lifrm(l) 

line . line(l) 

line, copy from standard input to standard output . line(l) 

line count . wc(l) 

line length, put line length specifications in text files . fspec(5) 

linear search and update . lsearch(3C) 

lines, count number contained in file . wc(l) 

lines, find common lines in two files . comm(l) 

lines, find unique lines in two files . comm(l) 

lines, merge in one or more files . paste(l) 

link . link(lM), link(2) 

link, copy, or move files . cp(l) 

link, create to or remove from file . link(lM), link(2), unlink(2) 

link editor . ld(l) 

link information utility, object files . linkinfo(l) 

linker. ld(l) 

linker/assembler executable output file, description of. a.out(5) 

linkinfo . linkinfo(l) 

lint . lint(l) 

list active processes in system. ps(l) 

list contents of BIF directories. bifis(l) 

list contents of directories . ls(l) 

list contents of LIF directory . lifis(l) 

list current users on system . who(l) 

list device drivers . Isdev(l) 

list file names with associated i-nodes . ncheck(lM) 

list spooled uucp transactions grouped by transaction . uuls(l) 

list users and their current processes . whodo(lM) 

11 . ls(l) 

In . cp(l) 

localtime . ctime(3C) 

locate files in file system. find(l) 

locate source, binary, and/or manual for program . whereis(l) 

lock . lock(l) 

lock process, text, or data in memory . plock(2) 

lock terminal. lock(l) 

lockf. lockf(2) 

lock/unlock process address space or segment . memlck(2) 

log . exp(3M) 

log gamma function . gamma(3M) 

log results of work requests on remote system . uucico(lM) 

loglO. exp(3M) 

logarithm, common. exp(3M) 

logarithm, natural . exp(3M) 

logging file for system errors . errfile(5) 

logging in on HP-UX . login(l) 

logical block, set number of bytes per logical block . sdfinit(lM) 

Logical Interchange Format description . 

login . login(l) 

login, establish baud rate and communication with terminal during. getty(lM) 

login name, get . logname(l), getlogin(3C) 

login name, get ASCII string representing . cuserid(3S) 

login name, print. id(l) 
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Permuted Index 


login name, record for each user (accounting) . utmp(5) 

login shell, change default . chsh(l) 

login time, record for each user (accounting) . utmp(5) 

logname . logname(l) 

logouts, run command immune to . nohup(l) 

long integer, convert to base-64 ASCII. a641(3C) 

long integer data access, machine independent . sputl(3X) 

long integers, convert to/from 3-byte integers . 13tol(3C) 

longjmp . setjmp(3C) 

lorder . lorder(l) 

lower-case to upper-case character conversion . conv(3C) 

Is. ls(l) 

Isdev. Isdev(l) 

Isearch . lsearch(3C) 

Iseek. lseek(2) 

Isf . ls(l) 

Isr . ls(l) 

Isx. ls(l) 

ltol3 . 13tol(3C) 

m4 . m4(l) 

machid . machid(l) 

machine ID, get . uname(l), uname(2) 

machine processor type . machid(l) 

machine-dependent values . values (7) 

macro processor. m4(l) 

macros for formatting entries in the HP-UX Reference manual. man(7) 

macros for formatting text . mm (7) 

magic numbers, description of. magic(5) 

magic.h, description of . magic(5) 

magnetic tape, description of raw interface and controls . mt(4) 

magnetic tape, manipulate and/or position . mt(l) 

mail . mail(l) 

mail, read or send to other users . mail(l) 

maintain libraries, archives . 9'i’(l) 

maintain, update, recompile programs . make(l) 

make . make(l) 

make a BIF directory. bifmkdir(l) 

make file system on special file . mkfs(lM) 

make posters in large letters . banner(l) 

make unprintable characters in a file visible or invisible . vis(l) 

makekey . makekey(lM) 

malloc . malloc(3C) 

man . man(l) 

man macros, description of. man(7) 

manage binary search trees . tsearch(3C) 

manage hash search tables . hsearch(3C) 

manipulate wtmp records . fwtmp(lM) 

mantissa, get from fioating point value. frexp(3C) 

manual, create preformatted manual pages for on-line . catman(lM) 

manual, on-line. man(l) 

manual page (on-line), locate for program . whereis(l) 

map characters into other characters during copy to standard output . fi‘(l) 

mapping, physical address . iomap(4) 

margins, put margin specifications in text files . fspec(5) 

mark Command Set 80 cartridge tape . tcio(l) 
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Permuted Index 


mark SDF operating system file as loadable/non-loadable. osmark(lM) 

mark/unmark volume as HP-UX root volume . rootmark(lM) 

mask, get/set file-creation . sli(l), umask(l), umask(2) 

master device information table . master(5) 

math . math(7) 

math functions and constants . math(7) 

mathematical error handling . matherr(3M) 

matherr . matherr(3M) 

MC68000 assembler . as(l) 

mediainit . mediainit(l) 

memadvise . memadvise(2) 

memallc. memallc(2) 

memberships, show group . groups (1) 

memchmd . memchmd(2) 

memfree . memallc (2) 

memlck. memlck(2) 

memory . memory(3C) 

memory, allocate a block of . malloc(3C) 

memory, allocate for array . malloc(3C) 

memory, change size of previously-allocated block . malloc(3C) 

memory, deallocate block of . malloc(3C) 

memory management, inform operating system about segment reference patterns . memadvise(2) 

memory management, modify segment length . memvary(2) 

memory operations. memory(3C) 

memory segment access modes, change . memchmd(2) 

memory space, allocate and free . memallc (2) 

memory, write to disc . sync(2), sync(l) 

memulck. memlck(2) 

memvary. memvary(2) 

merge contents of several files . sort(l) 

merge lines in one or more files . paste(l) 

merge or add total accounting files . acctmerg(lM) 

mesg . mesg(l) 

message catalogs: MPE/RTE . catread(3C) 

message control operations. msgctl(2) 

message operations . msgop(2) 

messages, permit/deny to your terminal . mesg(l) 

messages, read or send to other users . mail(l) 

messages, send to all users . wall(lM) 

messages, send to another user interactively . write(l) 

mkdev. mkdev(lM) 

mkdir . mkdir(l) 

mkdir . mkdir(2) 

mkfs . mkfs(lM) 

mklp . mklp(lM) 

mknod . mknod(2), mknod(lM) 

mknod.h, description of . mknod(5) 

mkstr . mkstr(l) 

mktemp . mktemp(3C) 

mm . mm(l) 

mm macros, description of . mm(7) 

mm macros, print documents formatted with . mm(l) 

mnttab table, create. setmnt(lM) 

mnttab.h, description of . mnttab(5) 

mod function, floating point. floor(3M) 
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Permuted Index 


mode, change for file .,. 

model, Native Language Support . 

model.h, description of. 

modem . 

modem control special file . 

modf . 

modify parameters of SCCS files . 

modify segment length. 

monitor . 

monitor uucp network . 

more . 

mount . 

mount or unmount file system . 

mounted devices, create table of . 

mounted devices, table of those mounted by mount (IM) . 

mounted file system, find special file associated with. 

mounted file system statistics . 

move a directory. 

move, link, or copy files . 

move read/write file pointer; seek . 

move to new working directory .. 

msgctl . 

msgget... 

msgop. 

mt . 

multiple line-feeds, remove from output . 

mv . 

mvdir . 

name, get login . 

name list (symbol table), extract entries from executable file’s name list 

name list (symbol table), print from object file . 

Native Language Support model . 

natural logarithm . 

ncheck . 

network, monitor uucp activity on . 

network special file, create . 

new file system . 

newfs . 

newfs . 

newgrp . 

new-line character, description of . 

new-line characters, remove extras from file . 

news . 

news, print current events . 

nice . 

nlist . 

nlist structure format . 

NLS character classification . 

NLS character set collating sequence tables . 

NLS character sets . 

NLS model. 

NLS native language information . 

NLS non-ASCII string collation . 

NLS translate characters . 

nl_string . 


. chmod(l), chmod(2) 

. hpnls(7) 

. model(5) 

. modem(4) 

. modem(4) 

. frexp(3C) 

. admin(l) 

. memvary(2) 

. monitor(3C) 

. uusub(lM) 

. more(l) 

. mount(lM), mount(2) 

mount(lM), mount(2), umount(2) 

.. setmnt(lM) 

.. mnttab(5) 

. devnm(lM) 

. ustat(2) 

. mvdir(lM) 

. cp(l) 

. lseek(2) 

. cd(l), sh(l), chdir(2) 

. msgctl(2) 

. msgget (2) 

. msgop(2) 

. mt(l) 

. ssp(l) 

. cp(l) 

.. mvdir(IM) 

. logname(l), getlogin(3C) 

. nlist (3C) 

. nm(l) 

. hpnls(7) 

. exp(3M) 

. ncheck(lM) 

. uusub(lM) 

. mknod(2), mknod(lM) 

. newfs (IM) 

. newfs(lM) 

. newfs (IM) 

. newgrp(l), sh(l) 

. tty(4) 

. rmnl(l) 

. news(l) 

. news(l) 

. nice(l), nice(2) 

. nlist (3C) 

. nlist(5) 

. nl_ctype(3C) 

. col__seq_8, col_seq_16 

.. ascii(7), kana8(7), roman8(7) 

. hpnls(7) 

. langinfo(3C) 

. nl_string(3C) 

. nl_conv(3C) 

. nl_string(3C) 
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Permuted Index 


nm . 

nodename, get . 

nodename, set/print name of current . 

nohup . 

non-ASCII string collation used by NLS. 

nroff. 

nroff, format tables for. 

nroff, interpret output from nroff for printing . 

nroff, troff, tbl, eqn constructs, remove from text . 

numbered-argument print output formatting . 

object code, locate for program. 

object file, debugger for . 

object file, extract symbol table (name list) entries from . 

object file, get size of . 

object file link information utility . 

object file, print symbol table (name list) of . 

object file, remove symbol table and relocation bits from . 

object files, combine into program . 

object library, find ordering relation for . 

octal, hexadecimal dump . 

od . 

on-line manual command . 

on-line manual, create preformatted manual pages for . 

open.. 

open a file and assign buffering to it . 

open file, assign buffering to . 

open file descriptor, duplicate . 

open file for reading or writing . 

operating system, append to an existing operating system. 

operating system, change to different OS or different version of same OS 

operating system, check integrity of OS in SDF boot area(s) . 

operating system, copy from one or more SDF boot areas to another . 

operating system, create new operating system from ordinary files . 

operating system management package description . 

operating system, mark as loadable or non-loadable . 

operating system, shut down OS with optional re-boot . 

operating system, split into one or more ordinary files . 

optarg . 

opterr . 

optimization routines; CRT screen and cursor control . 

optind . 

option letter, get from argv . 

options, parse command line . 

options, set for terminal . 

options, set shell . 

opx25 . 

ordering relation, find for object library or archive file . 

ordinary file, create . 

ordinary file, create or overwrite . 

OS, append to an existing operating system . 

OS, change to different OS or different version of same OS . 

OS, check integrity of operating system in SDF boot area(s) . 

OS, copy from one or more SDF boot areas to another . 

OS, create new operating system from ordinary files. 

OS management package description. 


. nm(l) 

revision(l), uname(l), uname(2) 

. hostname(l) 

. nohup(l) 

. nl_^tring(3C) 

. nroff(l) 

. tbl(l) 

. col(l) 

. deroff(l) 

. printmsg(3C) 

. whereis(l) 

. adb(l) 

. nlist(3C) 

. size(l) 

. linkinfo(l) 

. nm(l) 

. strip(l) 

. ld(l) 

. lorder(l) 

. od{l) 

. od(l) 

. man(l) 

. catman(lM) 

. open(2) 

. fopen(3S) 

. setbuf(3S) 

. dup2(2) 

. open(2) 

. oscp(lM) 

. chsys(lM)) 

. osck(lM) 

. oscp(lM) 

. oscp(lM) 

. osmgr(lM) 

. osmark(lM) 

.. stopsys(lM) 

. oscp(lM) 

. getopt(3C) 

. getopt(3C) 

. curses (3X) 

. getopt(3C) 

. getopt(3C) 

. getopt(l) 

. stty(l) 

. sh(l) 

. opx25(lM) 

. lorder(l) 

.. mknod(2) 

. creat(2) 

. oscp(lM) 

. chsys(lM) 

. osck(lM) 

. oscp(lM) 

. oscp(lM) 

. osmgr(lM) 


























































Permuted Index 


OS, mark as loadable or non-loadable . osmark(lM) 

OS, shut down operating system with optional re-boot . stopsys(lM) 

OS, split operating system into one or more ordinary files . oscp(lM) 

osck. osck(lM) 

oscp. oscp(lM) 

osmark . osmark(lM) 

osmgr . osmgr(lM) 

output character or word to open file or standard output . putc(3S) 

output, description of formatted/unformatted output to printer . lp(4) 

output, description of system handling of terminal output . tty(4) 

output, print formatted data into string . printf(3S) 

output, print formatted data on buffered open file . printf(3S) 

output, print formatted data on standard output . printf(3S) 

output string to open file or standard output. puts(3S) 

overlay program onto existing process and execute .. sh(l), exec(2) 

overview of accounting commands . acct(lM) 

owner, change for file . chown(l), chown(2) 

page. more(l) 

page size, set for paged data . uconfig(lM) 

paged data, set for program . chatr(l) 

paging and swapping enable . swapon(lM) 

PAM . pam(l) 

parameter substitution . sh(l) 

parameters, environment .. sh(l), environ(7) 

parameters, install in environment . sh(l) 

parameters, mark as readonly . sh(l) 

parameters, perform left-shift on positional . sh(l) 

parameters, set for terminal . stty(l) 

parameters, set for terminal on login. tset(l) 

parent process ID, get for process. getpid(2) 

parity, settings for terminal . tty(4) 

parse command line options . getopt(l) 

Pascal compiler . pc(l) 

passwd . passwd(l) 

password, change login . passwd(l) 

password encryption. crypt(3C) 

password file, close . getpwent(3C) 

password file, description of . passwd(5) 

password file, get line containing matching user ID . getpw(3C) 

password file, output line similar to those contained in . putpwent(3C) 

password file, read one line from . getpwent(3C) 

password file, rewind . getpwent(3C) 

password file, search for matching user ID . getpwent(3C) 

password file, search for matching user name . getpwent(3C) 

password, read from /dev/tty or standard input . getpass(3C) 

password/group file checkers . pwck(lM) 

paste . paste(l) 

path name, get for terminal . ttyname(3C) 

path name, isolate directory name from . basename(l) 

path name, isolate file name from . basename(l) 

pattern, find and process within text . awk(l) 

pattern, search contents of file for . grep(l) 

pause . pause(2) 

pause, suspend process for interval . sleep(3C) 

pc . pc(l) 
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Permuted Index 


pclose . popen(3S) 

PEEKC . regexp(7) 

periodic, automatic sync . syncer(l) 

permission bits, change for file . chmod(l), chmod(2) 

per-process accounting file format . acct(5) 

perror. perror(3C) 

personal applications manager, a command shell. pam(l) 

physical address mapping . iomap(4) 

pipe . pipe(2) 

pipe, create/close between process and command . popen(3S) 

pipe, get intermediate data from . tee(l) 

pipeline, create . pipe(2) 

pipeline, get intermediate data from . tee(l) 

place error messages from C source into a file . mkstr(l) 

plock . plock(2) 

plotter, description of hpib interface to . hpib(4) 

popen . popen(3S) 

port, database listing terminal type connected to each . tty type (5) 

portable code between HP-UX implementations, typedefs for . model(5) 

position magnetic tape . mt(l) 

positional parameters, perform left-shift on . sh(l) 

posters, make using large letters. banner(l) 

pow . exp(3M) 

power function . exp(3M) 

powerfail . brc(lM) 

pr. pr(l) 

prealloc . prealloc (1) 

preallocate disc storage . prealloc(l) 

preprocessor for C compiler . cpp(l) 

print and format files. pr(l) 

print and summarize an SCCS file . prs(l) 

print arguments after shell interpretation . echo(l) 

print, copy, and/or concatenate files . cat(l) 

print current SCCS file editing activity . sact(l) 

print documents formatted with mm macros . mm(l) 

print effective current user id . whoami(l) 

print formatted data on standard output, open file, or string . printf(3S) 

print formatted output from varargs argument list . vprintf(3S) 

print formatted output with numbered arguments . printmsg(3C) 

print last part of file . tail(l) 

print list of users and their current processes . whodo(lM) 

print name list (symbol table) of object file . nm(l) 

print name of current working directory. pwd(l) 

print news items . news(l) 

print time and date . date(l) 

print user, group IDs and names . id(l) 

printer, description of formatted/unformatted output . lp(4) 

printer, description of hpib interface to. hpib(4) 

printer options, set . slp(l) 

printf. printf(3S) 

printmsg . printmsg(3C) 

priority, run command at lower or higher . nice(l), nice(2) 

privileged values format . privgrp(5) 

procedures; shell procedures for accounting. acctsh(lM) 

process accounting . acctprc(lM) 
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Permuted Index 


process accounting commands . 

process and system state initialization. 

process, change data segment space allocation for . 

process, change root directory of . 

process, create a new . 

process, create/close pipe between process and command . 

process, enable break-point debugging of child process. 

process, format of core image of terminated process . 

process, get ID, group ID, and parent process ID of. 

process, get real/effective user and real/effective group ID’s for 

process, get/set file size limit for. 

process group ID, set . 

process, lock/unlock address space or segment . 

process number, get. 

process, overlay new program onto existing . 

process, print accumulated user and system time elapsed for ... 

process, send SIGIOT to . 

process, send signal to . 

process, set group ID for . 

process status, report . 

process, suspend execution for interval of time . 

process, suspend until signal... 

process, terminate. 

process, time execution of. 

process, wait for completion of. 

processes, list active. 

processes, send signal to all user processes . 

processes, specify maximum number of processes per user . 

processes, terminate all user processes . 

processor type . 

prof. 

profil . 

profile, create for program during execution . 

profile data, display . 

profile files, description of /etc/profile and $HOME/.profile .... 

program, add diagnostics to . 

program, change internal attributes of. 

program, check/verify C . 

program, create execution profile for . 

program, create from object files . 

program, debugger for . 

program, execute command from. 

program, force action associated with signal to be taken. 

program, format C . 

program, generate for lexical analysis of text. 

program, get particular addresses associated with . 

program, get size of . 

program, locate source, binary, and/or on-line manual page for 

program, maintain, update, and recompile. 

program, overlay onto existing process and execute . 

program, run immune to hangups, logouts, and quits . 

program, set up signal handling for . 

program verification . 

provide semaphores and record locking on files. 

provide truth value about your processor type . 


. acctcom(l) 

. init(lM) 

. brk(2) 

. chroot(l), chroot(2) 

. fork(2) 

. popen(3S) 

. ptrace(2) 

. core(5) 

. getpid(2) 

. getuid(2) 

. ulimit(2) 

. setpgrp(2) 

. memlck(2) 

. getpid(2) 

. sh(l), exec(2) 

. sh(l) 

. abort (3C) 

. kill(l), kill(2), abort(3C) 

. setpgrp(2) 

. Ps(l) 

. sleep(l), sleep(3C) 

. pause(2) 

kill(l), sh(l), exit(2), kill(2), abort(3C) 

. times(2) 

. sh(l), wait(l), wait(2) 

. ps(l) 

. kmall(lM) 

. uconfig(lM) 

. shutdown(lM) 

. machid(l) 

. prof(l) 

.. profil(2) 

. profil(2), monitor(3C) 

. prof(l) 

. profile(5) 

. assert (3X) 

. chatr(l) 

. lint(l) 

. profil(2), monitor(3C) 

. ld(l) 

. adb(l) 

. system(3S) 

. ssignal(3C) 

. cb(l) 

. lex(l) 

. end(3C) 

. size(l) 

. whereis(l) 

. make(l) 

. sh(l), exec(2) 

. nohup(l) 

. signal(2), ssignal(3C) 

. assert (3X) 

. lockf(2) 

.. machid(l) 
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Permuted Index 


prs . prs(l) 

PS. ps(l) 

pseudo-random number generator. drand48(3C) 

pseudo-random numbers . drand48(3C) 

pseudo-terminal driver . pty(4) 

ptrace . ptrace(2) 

Pty . pty(4) 

public UNIX-to-UNIX file copy . uuto(l) 

push character back into input stream . ungetc(3S) 

putc. putc(3S) 

putchar . putc(3S) 

putenv . putenv{3C) 

putpwent . putpwent(3C) 

puts . puts{3S) 

putw. putc(3S) 

pwck . pwck(lM) 

pwd . pwd(l) 

pwd.h. passwd(5) 

Pythagorean theorem function . hypot{3M) 

qsort . qsort(3C) 

query . query (1) 

quit character, description of. tty (4) 

quits, run command immune to . nohup(l) 

quoting, as used by the shell. sh(l) 

rand . rand(3C) 

random number generator . drand48(3C) 

random number generator . rand(3C) 

randomized library/archive, table of contents format description . ranlib(5) 

ranlib.h, description of . ranlib(5) 

raw interface to disc, description of... disc(4) 

raw mode, description of raw mode interface to magnetic tape . mt(4) 

raw mode, description of raw output to printer . lp(4) 

rc . brc(lM) 

read . sh(l), read(2) 

read and format data from buffered open file . scanf(3S) 

read and format data from standard input. scanf(3S) 

read and format data from string . scanf(3S) 

read character from buffered open file . getc(3S) 

read error indicator on open file . ferror(3S) 

read from a file using buffers . fread(3S) 

read from file . read(2) 

read from standard input . sh(l) 

read operation, reposition next . fseek(3S) 

read password from /dev/tty or standard input . getpass(3C) 

read text in convenient chunks on soft-copy terminal . more(l) 

read word from buffered open file . getc(3S) 

read-ahead, set number of buffers allocated to. uconfig(lM) 

readonly. sh(l) 

read/write file pointer, move (seek) . lseek(2) 

real group ID, get for process . getuid(2) 

real user ID, get for process . getuid(2) 

realloc. malloc(3C) 

real-time priority, change or read . rtprio(2) 

real-time priority, execute process with . rtprio(l) 

reblock tape file. dd(l) 
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Permuted Index 


reboot . 

reboot. 

re-boot operating system after shut-down . 

reboot system. 

reboot the system . 

record locking and semaphores on files . 

record login names, login times, and tty names for user 

regexp.h, description of. 

regular expression compile and match routines . 

relational database operator . 

release blocked signals and wait for interrupt . 

release Command Set 80 cartridge tape. 

release number, get current . 

relocation bits, remove from object file . 

remind you when you have to leave . 

remind you when you have to leave . 

reminder service . 

remote system, execute work requests on . 

remove a directory file . 

remove a LIF file . 

remove backing store devices . 

remove BIF files or directories . 

remove delta from SCCS file . 

remove duplicate lines in file . 

remove extra new-line characters from file . 

remove files or directories . 

remove link to file. 

remove message queue. 

remove multiple line-feeds from output . 

remove nroff/troff, tbl, and eqn constructs. 

remove selected fields from each line of a file . 

remove selected table column entries from file . 

remove semaphore set . 

remove shared memory id . 

remove symbol table and relocation bits from object file 

rename LIF files . 

repair file system inconsistencies . 

report inter-process communication facilities status . 

report number of free disc blocks . 

report CPU time used . 

reserve a terminal . 

reset error indicator on open file. 

RETURN . 

revck . 

reverse line-feeds and backspaces, interpret for nroff(l) . 

reverse previous of SCCS file. 

revision .. 

revision information, get HP-UX. 

revision numbers, check for HP-UX files . 

rewind . 

rewind a file . 

rewind group file. 

rewind magnetic tape . 

rewind password file . 

rm. 


. reboot(lM) 

. reboot (2) 

. stopsys(lM) 

. reboot (IM) 

. reboot(2) 

. lockf(2) 

. utmp(5) 

. regexp (7) 

. regexp (7) 

. join(l) 

. sigpause(2) 

. tcio(l) 

revision(l), uname(l), uname(2) 

. strip(l) 

. leave(l) 

. leave(l) 

. calendar(l) 

.. uucico(lM), uux(l) 

. rmdir(2) 

. lifrm(l) 

. vson(2) 

. bifrm(l) 

. rmdel(l) 

. uniq(l) 

. rmnl(l) 

. rm(l) 

. link(lM), unlink(2) 

. ipcrm(l) 

. ssp(l) 

... deroff(l) 

. cut(l) 

. cut(l) 

. ipcrm(l) 

. ipcrm(l) 

. strip(l) 

. lifrename(l) 

. fsck(lM), fsdb(lM) 

. ipcs(l) 

. bifdf(l) 

. clock(3C) 

. lock(l) 

. ferror(3S) 

. regexp (7) 

. revck (IM) 

. col(l) 

. unget (1) 

. revision(l) 

. revision(l) 

. revck(lM) 

. fseek(3S) 

. fseek(3S) 

. getgrent(3C) 

. mt(l) 

. getpwent(3C) 

. rm(l) 
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Permuted Index 


rmail. mail(l) 

rmdel. rmdel(l) 

rmdir . rm(l) 

rmdir . rmdir(2) 

rmnl . rmnl(l) 

romanS . roman8(7) 

root directory, change for duration of command. chroot(l), chroot(2) 

root volume, mark/unmark volume as HP-UX root volume . rootmark(lM) 

rootmark . rootmark(lM) 

rtprio . rtprio(l) 

run a command at low priority . nice(l), nice(2) 

run a command immune to hangups, logouts, and quits . nohup(l) 

run daily accounting . runacct(lM) 

runacct . runacct(lM) 

CPU time report . clock(3C) 

CS/80 cartridge tape special file. ct(4) 

GPIO routines (device I/O library) . gpio_*(3I) 

HALGOL programs . opx25(lM) 

HP-IB routines (device I/O library) . hpib_*(3I) 

IMAGE database access . query (1) 

I/O routines (device I/O library) . io_*(3I) 

KERMIT-protocol file transfer program. kermit(lM) 

LP spooler system, configure . mklp(lM) 

MPE/RTE-style message catalog support . catread(3C) 

MPE/RTE-style message catalog support . catread(3C) 

UUCP system snapshot . uusnap(l) 

XMODEM protocol file transfer program. umodem(lM) 

XMODEM protocol file transfer program. umodem(lM) 

sact . sact(l) 

sbrk . brk(2) 

scan text for pattern and process . awk(l) 

scanf. scanf(3S) 

sees, ask for help concerning. help(l) 

sees file, change delta commentary of . cdc(l) 

sees file, check for validity . val(l) 

sees file, compare two versions of. sccsdiff(l) 

sees file, create delta (change) for. delta(l) 

sees file, description of SeeS file format . sccsfile(5) 

sees file, get identification information from . what(l) 

sees file, get version of. get(l) 

sees file, print and summarize . prs(l) 

sees file, print current editing activity for . sact(l) 

sees file, print delta summary of. get(l) 

sees file, remove delta from . rmdel(l) 

sees file, reverse previous get(l) of . unget(l) 

sees files, create or change parameters of . admin(l) 

scesdiff . sccsdiff(l) 

schedule commands at specified date(s) and time(s) . at(l), cron(lM) 

screen handling and optimization routines . curses (3X) 

SDF boot area, copy OS from one or more SDF boot areas to another . oscp(lM) 

SDF, description of. dir(5) 

SDF, description of SDF volume . fs(5) 

SDF volume, format, initialize, and certify . sdfinit(lM) 

sdfinit . sdfinit(lM) 

search an ASGII file for pattern . grep(l) 
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Permuted Index 


search tables, hash-coded . 

security control, dialup . 

sed . 

seek to new position in file. 

segment length, modify. 

segment, lock/unlock for process . 

segment reference patterns, inform operating system about 

select . 

select/reject common lines of two files . 

semaphore control operations . 

semaphore operations . 

semaphores and record locking on files . 

semaphores, get . 

semctl. 

semget . 

semop . 

send mail to users or read mail . 

send signal to all user processes. 

set. 

set current signal mask . 

set group access list . 

set name of host cpu . 

set options for terminal port . 

set or change real-time priority . 

set or print name of current host system . 

set printer options . 

set process’s alarm clock .. 

set special attributes for group. 

set system parameters . 

set tabs on a terminal. 

set the modes of a terminal. 

set time and date . 

set user and group IDs . 

setbuf. 

setgid . 

setgrent . 

set-group-ID bit, set/clear for file . 

setgroups . 

sethostname . 

setitimer . 

setjmp . 

setkey . 

setmnt. 

setpgrp . 

setprivgrp. 

setprivgrp . 

setpwent. 

settimeofday . 

setuid. 

set-user-ID bit, set/clear for file . 

sh.. 

shareable, mark or unmark program code as . 

shared memory control operations . 

shared memory operations . 

shared memory segment, get . 


. hsearch(3C) 

. dialups(5) 

. sed(l) 

. lseek(2) 

. memvary(2) 

. memlck(2) 

. memadvise(2) 

. select(2) 

. comm(l) 

. semctl (2) 

. semop (2) 

. lockf(2) 

. semget (2) 

. semctl (2) 

. semget (2) 

. semop (2) 

. mail(l) 

. killall(lM) 

. Sh(l) 

. sigsetmask(2) 

. setgroups (2) 

.. sethostname(2) 

. stty(l) 

. rtprio(l) 

. hostname(l) 

. slp(l) 

. alarm(2) 

. setprivgrp(lM) 

. uconfig(lM) 

. tabs(l) 

. getty(lM) 

. date(l), stime(2) 

. setuid(2) 

. setbuf(3S) 

. setuid(2) 

. getgrent(3C) 

. chmod(l), chmod(2) 

. setgroups (2) 

. sethostname(2) 

. setitimer(2) 

. setjmp(3C) 

. crypt (3C) 

. setmnt (IM) 

. setpgrp (2) 

. setprivgrp(IM) 

setprivgrp(lM), setprivgrp(2) 

. getpwent(3C) 

. settimeofday(2) 

. setuid(2) 

. chmod(l), chmod(2) 

. sh{l) 

. chatr(l) 

. shmctl(2) 

. shmop(2) 

. shmget(2) 
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Permuted Index 


shell . sh(l) 

shell, change default login . chsh(l) 

shell command, issue from program. system{3S) 

shell, command. Personal Applications Manager . pam(l) 

shell, input commands to . sh(l) 

shell procedures for accounting . acctsh(lM) 

shell programming language . sh(l) 

shell scripts, system initialization. brc(lM) 

shell, set/clear flags to . sh(l) 

shift . sh(l) 

shmctl . shmctl(2) 

shmget . shmget(2) 

shmop . shmop(2) 

show group memberships . groups (1) 

shut down operating system with optional re-boot . stopsys(lM) 

shutdown . shutdown(lM) 

shutdown status of specified file system . fsclean(lM) 

sigblock. sigblock(2) 

sign on . login(l) 

signal. signal(2) 

signal facilities, software . sigvector(2) 

signal, force action associated with signal to be taken. ssignal(3C) 

signal handling for program, set up . signal(2), ssignal(3C) 

signal mask, set . sigsetmask(2) 

signal, send SIGIOT to process . abort(3C) 

signal, send to all user processes. killall(lM) 

signal, send to process . kill(l), kill(2), abort(3C) 

signal, set trap for . sh(l) 

signal stack space . sigspace(2) 

signal, suspend process until receipt of. pause(2) 

signgam . gamma(3M) 

signs, make using large letters . banner(l) 

sigpause. sigpause(2) 

sigsetmask . sigsetmask(2) 

sigspace . sigspace(2) 

sigvector . sigvector(2) 

simple text formatter. adjust (1) 

sin . trig(3M) 

sine function. trig(3M) 

sine, hyperbolic. sinh(3M) 

sinh . sinh(3M) 

size . size(l) 

size of an object file . size(l) 

sleep . sleep (1) 

sleep. sleep(3C) 

sip. slp(l) 

snapshot of the UUCP system . uusnap(l) 

software signal facilities. sigvector(2) 

sort . sort(l) 

sort algorithm. qsort(3C) 

sort and/or merge files . sort(l) 

sort, topological . tsort(l) 

source code, locate for program . whereis(l) 

spaces, convert to tabs, and vice versa . expand(l) 

special characters in terminal interface, description of . tty(4) 
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Permuted Index 


special file, create block/character/network . 

special file, create fifo . 

special file, identify for file name on mounted file system . 

special file, modem control . 

special file, CS/80 cartridge tape. 

special file, system "bit bucket" . 

special files, perform functions on . 

special files, utilities used in creating special files . 

spell . 

spellin. 

spelling errors, find. 

spellout . 

split . 

split a file into pieces. 

split operating system into one or more ordinary files. 

spool directory clean-up for uucp . 

sprintf . 

sputl . 

sqrt.;. 

square root function . 

srand ... 

sscanf . 

ssignal . 

ssp . 

stack size, specify size in bytes.. 

standard input, copy one line from to standard output . 

standard input, read from. 

standard inter-process communication package . 

start character, resume output, description of. 

stat . 

stat(2)/fstat(2), description of structure returned by these calls 

state, defining system states for init(lM) . 

state, initialization of system state and processes ... 

stat.h, description of . 

status flags, get/set for file . 

status, get for file . 

status, inter-process communication facilities. 

stdio . 

stdipc . 

step . 

sticky bit, set/clear for file . 

stime. 

stop character, suspend output, description of . 

stop operating system with optional re-boot . 

stopsys. 

strcat . 

strchr. 

strcmp . 

strcpy .. 

strcspn . 

stream, close or flush . 

stream text editor . 

string collation, non-ASCII, used by NLS . 

string, copy. 

string, get length of . 


mkdev(lM), mknod(2), mknod(lM) 

. mknod(2), mknod(lM) 

. devnm(lM) 

.. modem(4) 

. ct(4) 

. null (4) 

. ioctl(2), stty(2) 

. mknod(5) 

. spell(l) 

. spell(l) 

. spell(l) 

. spell(l) 

.. split(l) 

. split(l) 

. oscp(lM) 

. uuclean(lM) 

.. printf(3S) 

. sputl(3X) 

.. exp(3M) 

. exp(3M) 

. rand(3C) 

. scanf(3S) 

. ssignal(3C) 

. ssp(l) 

.. uconfig(lM) 

. line(l) 

. sh(l) 

. stdipc(3C) 

. tty(4) 

. stat(2) 

. stat(7) 

. inittab(5) 

. init(lM) 

. stat(7) 

. fcntl(2) 

. stat(2) 

. ipcs(l) 

. stdio(3S) 

. stdipc(3C) 

. regexp (7) 

. chmod(l), chmod(2) 

. stime(2) 

. tty(4) 

. stopsys(IM) 

. stopsys (IM) 

. string(3C) 

. string(3C) 

. string(3C) 

. string(3C) 

. string(3C) 

. fclose(3S) 

. sed(l) 

. nl_string(3C) 

. string(3C) 

. string(3C) 
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Permuted Index 


string, print formatted data into . printf(3S) 

string, read and format data from . scanf(3S) 

string, read from buffered open file . gets(3S) 

string, search contents of file for specified . grep(l) 

string, search for particular character in . string(3C) 

string to double-precision integer conversion. strtod(3C) 

string, write to open file or standard output . puts(3S) 

strings, compare two . string(3C) 

strings, concatenate two . strmg(3C) 

string-to-integer conversion . strtol(3C) 

strip . strip(l) 

strip multiple line-feeds from output . ssp(l) 

strlen . string(3C) 

strncat . string(3C) 

strncmp . string(3C) 

strncpy . string(3C) 

strpbrk . string(3C) 

strrchr . string(3C) 

strspn . string(3C) 

strtod . strtod(3C) 

strtok . string(3C) 

strtol . strtol(3C) 

structure, definition of structure returned by stat(2) and fstat(2) . stat(7) 

Structured Directory Format, description of. dir(5) 

Structured Directory Format, description of SDF volume . fs(5) 

Structured Directory Format volume, format, initialize, and certify . sdfinit(lM) 

stty . stty(l) 

stty . stty(2) 

sttyv6 . sttyv6(4) 

su. su(l) 

summarize and print SCCS file . prs(l) 

superblock, description of superblock in SDF volume . fs(5) 

suspend process execution for interval of time . sleep(l), sleep(3C) 

suspend process until signal. pause(2) 

swab . swab(3C) 

swap bytes . swab(3C) 

swap device, add. swapon(2) 

swap time, set for virtual segment . uconfig(lM) 

swapon . swapon(lM) 

swapon . swapon(2) 

swapping and paging enable . swapon(lM) 

symbol table, extract entries from executable file’s symbol table (name list) . nlist(3C) 

symbol table, print from object file . nm(l) 

symbol table, remove from object file . strip(l) 

symbols, examine execution profile for . prof(l) 

sync . sync(2), sync(l), syncer(l) 

syncer . syncer(lM) 

sync, automatic periodic . syncer(lM) 

synchronous I/O multiplexing . select(2) 

sys_errlist . perror(3C) 

sys_nerr . perror(3C) 

system . system(3S) 

system activity, terminate all current activity . shutdown(lM) 

system calls, error indicator for. errno(2) 

system configuration . config(lM) 
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Permuted Index 


system error logging file . 

System III compatibility for magnetic tape, description of . 

system initialization shell scripts . 

system name, get. 

system names, list of those known to uucp . 

system parameters, set or list . 

system reboot. 

system reconfiguration . 

system state, defining states for init(lM) . 

system state, initialization of. 

table of contents format description for archives/libraries . 

table of devices mounted by mount(lM) . 

table of mounted devices, create . 

table search, binary . 

tables, format for nroff/troff . 

tabs . 

tabs, expand to spaces, and vice versa . 

tabs, put tab specifications in text files . 

tabs, set on terminal. 

tail . 

tan . 

tangent function . 

tangent, hyperbolic . 

tanh. 

tape, archive files on. 

tape. Command Set 80 cartridge utility . 

tape density, how to set for magnetic tape . 

tape, description of magnetic tape raw interface and controls . 

tape file archiver. 

tape file, convert, reblock, translate and/or copy . 

tape initialization . 

tape, manipulate and/or position. 

tape, unpack/extract files from Command Set 80 cartridge . 

tar . 

tbl . 

tbl, nroff, troff, eqn constructs, remove from text . 

tcio . 

tee . 

temporary file, create and open . 

temporary file, generate name for . 

termcap. 

termcap description to terminfo description, convert . 

terminal capabilities, database for vi editor . 

terminal capabilities in terminfo(5), access . 

terminal commands, description of ioctl(2) system call commands .... 

terminal, database listing terminal type for each port . 

terminal dependent initialization . 

terminal, description of general interface to . 

terminal driver, pseudo- . 

terminal emulation, asynchronous . 

terminal, establish communication with terminal for login . 

terminal, facilitate viewing of continuous text on . 

terminal, find baud rate of terminal during login process . 

terminal flags, mapping between pwb/V6 UNIX and current HP-UX 
terminal, generate file name for . 


. errfile(5) 

. mt(4) 

. brc(lM) 

revision(l), uname(l), uname(2) 

. uucp(l) 

. uconfig(lM) 

. reboot(lM) 

. uconfig(lM) 

. inittab(5) 

. init(lM) 

. ranlib(5) 

. mnttab(5) 

.. setmnt(lM) 

. bsearch(3C) 

. tbl(l) 

. tabs(l) 

. expand(l) 

. fspec(5) 

. tabs(l) 

. tail(l) 

. trig(3M) 

. trig(3M) 

. sinh(3M) 

. sinh(3M) 

. tar(l) 

. tcio(l) 

. mt(4) 

. mt(4) 

. tar(l) 

. dd(l) 

. mediainit(l) 

. mt(l) 

. upm(l) 

. tar(l) 

. tbl(l) 

. deroff(l) 

. tcio(l) 

. tee(l) 

. tmpfile(3S) 

. tmpnam(3S) 

. termcap(3C), terminfo(5) 

. captoinfo(lM) 

. terminfo(5) 

. termcap(3C) 

. tty(4) 

. ttytype(5) 

. tset(l) 

. tty(4) 

. pty(4) 

. aterm(l) 

. getty(lM) 

. more(l) 

. getty(lM) 

. tty(4) 

. ctermid(3S) 
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Permuted Index 


terminal, get path name of . 

terminal, get path name of user’s . 

terminal input control, description of . 

terminal interface, general. 

terminal interface, version 6/PWD-compatibility . 

terminal, permit/deny messages to. 

terminal screen, clear . 

terminal screen handling and optimization routines . 

terminal, set options for . 

terminal, set tabs on. 

terminal, set type and mode on login . 

terminal, test file descriptor for association with . 

terminals, list of recognized terminal names . 

terminals, list of supported terminals in terminfo(5) . 

terminate a process . 

terminate all users’ processes . 

terminfo compiler. 

terminfo database access . 

terminfo description from termcap description, convert . 

termio . 

test . 

test conditional expressions . 

text editor . 

text editor, database of terminal capabilities for vi . 

text editor, stream . 

text editor (variant of ex for casual users) . 

text editor, visual . 

text, facilitate CRT viewing of continuous . 

text file, put format specifications in . 

text, find spelling errors in . 

text format specifications, put in text file . 

text formatter . 

text formatter, simple. 

text formatting, description of man macros. 

text formatting, description of mm macros . 

text formatting, remove nroff/troff/tbl/eqn constructs from text 

text, generate programs for lexical analysis of . 

text pattern scanning and processing language . 

text, print using mm macros . 

tgetent . 

tgetflag . 

tgetnum . 

tgetstr . 

tgoto . 

three-way differential file comparison . 

tic . 

time. 

time. 

time a command . 

time and date, convert to ASCII string. 

time and date, get more precisely . 

time, corrected for daylight saving time and time zone . 

time execution of a process and its child processes .. 

time, get seconds since 00:00:00 GMT, January 1, 1970 . 

time, get/set . 


. ttyname(3C) 

. tty(l) 

. tty{4) 

. termio(4) 

. sttyv6(4) 

. mesg(l) 

. clear(l) 

. curses (3X) 

. stty(l) 

. tabs(l) 

. tset(l) 

. ttyname(3C) 

. term(7) 

. term{7) 

kill(l), sh(l), exit(2), kill(2), abort(3C) 

. shutdown(lM) 

. tic(lM) 

. tput(l) 

. captoinfo(lM) 

. termio (4) 

. sh(l), test(l) 

. sh(l), test(l) 

. ed(l), ex(l) 

. terminfo(5) 

. sed(l) 

. edit(l) 

. vi{l) 

. more(l) 

. fspec(5) 

. spell (1) 

. fspec(5) 

. nroff(l) 

. adjust (1) 

. man(7) 

. mm(7) 

. deroff(l) 

. lex(l) 

. awk(l) 

. mm(l) 

. termcap (3C) 

. termcap(3C) 

. termcap(3C) 

. termcap(3C) 

. termcap(3C) 

. diff3(l) 

. tic(lM) 

. time(l) 

. time(2) 

. time(l) 

. ctime(3C) 

. ftime(2) 

. ctime(3C) 

. times (2) 

. time(2) 

. gettimeofday(2) 
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Permuted Index 


time, print elapsed user and system time for process . 

time, set and/or print . 

time to leave . 

time zone, time corrected for. 

time/date stamps, correct those on wtmp records . 

times. 

timezone. 

tmpfile. 

tmpnam . 

toascii. 

—tolower . 

tolower . 

topological sort . 

touch . 

—toupper . 

toupper . 

tput . 

tputs . 

tr . 

transfer files between two systems . 

translate assembly language . 

translate characters during copy from standard input to standard output 

translate characters for NLS . 

translate tape file . 

trap . 

trap numbers for hardware . 

trap, set for particular signal . 

trapno . 

trapno, report value for last command failure . 

trigonometric functions . 

troff, format tables for . 

troff, nroff, tbl, eqn constructs, remove from text . 

true. 

truth value about your processor type . 

truth values ... 

tset . 

tsort . 

tty . 

tty name, record for each user (accounting) . 

tty port, database listing terminal type connected to each . 

ttyname . 

ttyslot . 

tune a file system . 

type declarations, data type definitions for system code . 

typedefs for code portability between HP-UX implementations . 

types.h, description of. 

tzname . 

tzset . 

uconfig . 

ul . 

ulimit . 

umask. 

umodem. 

umount . 

uname . 


. sh(l) 

. date(l), stime(2) 

. leave(l) 

. ctime(3C) 

. fwtmp(lM) 

. sh(l), times(2) 

. ctime(3C) 

. tmpfile(3S) 

. tmpnam(3S) 

. conv(3C) 

. conv(3C) 

. conv(3C) 

. tsort(1) 

. touch(l) 

. conv(3C) 

. conv{3C) 

. tput(l) 

. termcap(3C) 

. tr(l) 

. uucp(l), uuto(l) 

. atrans(l) 

.Ml) 

. nl_conv(3C) 

. dd(l) 

. sh(l) 

. trapno(2) 

sh(l), signal(2), ssignal(3C) 

. trapno (2) 

. err(l) 

. trig(3M) 

. tbl(l) 

. deroff(l) 

. true(l) 

. machid(l) 

. true(l) 

. tset(l) 

. tsort(1) 

. tty(l) 

. utmp(5) 

. ttytype(5) 

. ttyname(3C) 

. ttyslot(30) 

. tunefs(lM) 

. types(7) 

. model(5) 

. types(7) 

. ctime(3C) 

. ctime(3C) 

. uconfig(lM) 

. nl(l) 

. ulimit (2) 

sh(l), umask(l), umask(2) 

. umodem(lM) 

. moimt(lM), umount (2) 

. uname(1), uname (2) 
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Permuted Index 


unblocked disc interface, description of. 

uncompact . 

uncompiler: terminfo . 

underlining, translate underscores to terminal escape sequence. 

underscores, translate to terminal escape sequence for underlining 

unexpand . 

unget . 

UNGETC . 

ungetc . 

uniformly-distributed pseudo-random number generator . 

uniq. 

unique lines, find after comparing two files . 

UNIX/HP-UX system, establish communication with another . 

unlink . 

unlock/lock process address space or segment . 

unmount or mount file system . 

unpack cpio archives from HP media ... 

unprintable characters in a file visible or invisible . 

untie . 

update access/modification/change times of file. 

update, maintain, recompile programs ... 

update super-block . 

upm . 

upper-case to lower-case character conversion . 

use findstring output to insert calls to getmsg . 

user crontab file . 

user environment, description of. 

user ID, get line from password file with matching . 

user ID, print . 

user ID, search password file for matching . 

user ID, set .. 

user name, print . 

user name, search password file for matching. 

user processes, terminate all . 

user, switch to another . 

users, print list of current . 

users, print list of users and their current processes . 

ustat . 

utilities. Bell Interchange Format file operations .. 

utime. 

utmp accounting file, description of . 

utmp file current user slot . 

utmp.h, description of. 

uucico . 

unclean . 

UUCP . 

UUCP command execution. 

UUCP network, monitor activity . 

UUCP spool directory clean-up .. 

UUCP system names, list of... 

UUCP transactions grouped by transaction, list . 

uucp/uux transactions, log of . 

uulog . 

uuls . 

uuname. 


.. disc (4) 

. compact (1) 

. untie (IM) 

. Ul{l) 

. Ul(l) 

. expand(l) 

. unget (1) 

. regexp (7) 

. ungetc(3S) 

. drand48(3C) 

. uniq(l) 

. comm(l) 

. cu(l) 

. link(lM), unlink(2) 

. memlck(2) 

mount(lM), mount(2), umount(2) 

. upm(l) 

. vis(l) 

.. untie (IM) 

. touch(l), utime(2) 

. make(l) 

. sync(2), sync(l) 

. upm(l) 

. conv(3C) 

. insertmsg(l) 

. crontab(l) 

. environ (7) 

. getpw(3C) 

. id{l) 

. getpwent(3C) 

. setuid(2) 

. id(l) 

. getpwent(3C) 

. shutdown(lM) 

. su(l) 

. who(l) 

. whodo(lM) 

. ustat(2) 

. bif(5) 

. utime(2) 

. utmp(5) 

. ttyslot(3C) 

. utmp(5) 

. uucico(lM) 

. uuclean(lM) 

. uucp(l) 

. uuxqt(lM) 

. uusub(lM) 

. uuclean(lM) 

. uucp(l) 

. uuls(l) 

. uucp(l) 

. uucp(l) 

. uuls(l) 

. uucp(l) 
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Permuted Index 


uupick . uuto(l) 

uusnap . uusnap(l) 

uusub . uusub(lM) 

uuto . iiuto(l) 

uux. uux(l) 

uuxqt . uuxqt(lM) 

val . val(l) 

validate password and group files . pwck(lM) 

validate SCCS file . val(l) 

values . values (7) 

values, machine-dependent . values (7) 

varargs . varargs(7) 

varargs argument list, print formatted output from . vprintf(3S) 

variable argument list handling facility . varargs (7) 

verify C program . lint(l) 

verify Command Set 80 cartridge tape . tcio(l) 

verify file system consistency . fsck(lM) 

verify password and group files . pwck(lM) 

version 6/PWD-compatibility terminal interface. sttyv6(4) 

version name, get for HP-UX. uname(l), uname(2) 

version number, get . revision(l) 

versions, compare two SCCS file versions . sccsdiff(l) 

vfork . fork(2) 

vi... vi(l) 

vi editor, database of terminal capabilities for . terminfo(5) 

view . vi(l) 

viewing text, facilitate on soft-copy terminals . more(l) 

virtual memory page pool, specify maximum size of . uconfig(lM) 

virtual memory usage, set or clear for program . chatr(l) 

virtual memory working set ratio, set . uconfig(lM) 

virtual segment, establish time segment remains memory resident . uconfig(lM) 

vis . vis(l) 

visual text editor . vi(l) 

volume, description of SDF volume superblock . fs(5) 

volume, format, initialize, and certify SDF volume . sdfinit(lM) 

volume header, write LIF on file . lifinit(l) 

volume, mark/unmark as HP-UX root volume . rootmark(lM) 

vprintf. vprintf(3S) 

vsadv . vsadv(2) 

vsoff . vson(2) 

vson . vson(2) 

wait . sh(l), wait(l), wait(2) 

wait for completion of process. sh(l), wait(l), wait(2) 

walk a file tree . ftw(3C) 

wall . wall(lM) 

wc . wc(l) 

wc . wc(l) 

what . what(l) 

whereis . whereis(l) 

while loop, exit from enclosing. sh(l) 

while loop, resume the next iteration of. sh(l) 

who. who(l) 

whoami . whoami(l) 

whodo . whodo(lM) 

word count . wc(l) 
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word, read from buffered open file . getc(3S) 

word, write on buffered open file or standard output . putc(3S) 

words, count number contained in file . wc(l) 

working directory, change . cd(l), sh(l), chdir(2) 

working directory, print name of . pwd(l) 

write . write(l), write(2) 

write character on buffered open file or standard output . putc(3S) 

write current contents of memory to disc . sync(2), sync(l) 

write interactively to another user . write(l) 

write LIF volume header on file . lifinit(l) 

write on a file . write(2) 

write operation, reposition next . fseek(3S) 

write password file entry . putpwent(3C) 

write string to open file or standard output . puts(3S) 

write to a file using buffers . fread(3S) 

write to all users . wall(lM) 

write word on buffered open file or standard output . putc(3S) 

wtmp accounting file, description of . utmp(5) 

wtmp records, convert from binary to ASCII . fwtmp(lM) 

wtmp records, correct time/date stamps on. fwtmp(lM) 

wtmpfix . fwtmp(lM) 

X.25 line, get . getx25(lM) 

xd. od(l) 

yO . bessel(3M) 

yl . bessel(3M) 

yacc . yacc(l) 

yn . bessel(3M) 
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